Vue3中获取DOM元素的几种方式总结

作者:青山有信时间:2026-10-25 23:57:22浏览:105

本文总结Vue3中获取DOM元素的多种方法。包括使用原生JS、通过ref获取单个元素、在v-for循环中获取多个DOM,以及在swiper组件中获取实例。针对深层嵌套的ref,介绍了使用getCurrentInstance在setup或生命周期中获取refs对象的方法,并提供具体代码示例。

在Vue3中获取DOM元素有多种方式,具体取决于使用场景。

第一种方法是利用原生JavaScript获取DOM元素。

document.querySelector(选择器)
document.getElementById(id选择器)
document.getElementsByClassName(class选择器)

第二种方法是通过Vue3的ref属性来获取单个DOM元素。

<template>
   <div ref='divDom'></div> 
</template>
<script setup>
import { ref} from 'vue'
const divDom = ref(null);
onMounted(()=>{
    console.log('获取dom元素',divDom)
})

第三种方法是处理v-for循环中的多个DOM元素。

<template>
   <div ref='getDivDom' v-for="item in list" :data-id="item.id"></div> 
</template>
<script setup>
import { ref} from 'vue'
const divDomList = ref(new Map());

const getDivDom = el=>{
    if(el){
        divDomList.set(el.dataset['id'],el) 
    }
}

// const el =divDomList.get(id) // 根据list数据中的id值 获取对应的dom元素 

第四种方法是在swiper组件中获取其DOM元素。

<template>
   <swiper @swiper='getSwiper'></swiper > 
</template>
<script setup>
import swiper from 'swiper'
import { ref} from 'vue'
const swiperDom= ref(null);

const getSwiper= el=>{
    swiperDom.value = el;
}

Vue3中ref获取dom(包含for循环)

在Vue3中通过ref获取DOM元素时,可能会遇到不同的情况。以下是几种常见场景及解决方案。

情况一:单纯获取某个DOM元素

这种情况相对简单,只需在JavaScript中定义一个与HTML元素ref属性同名的变量即可。

示例代码如下:

<template>
  <div class="box" ref="boxRef">
    box
  </div>
</template>

<script lang="ts" setup>
import { onMounted, ref } from 'vue';

const boxRef = ref<HTMLElement>() // 这里定义一个和div中ref名字一样的变量名即可

onMounted(() => {
  if (boxRef.value) {
    console.log(boxRef.value)
  }
})
</script>

在Vue3中获取DOM元素有多种方式,具体取决于使用场景。

情况二:在for循环中获取DOM元素

此时,可以通过动态设置ref的方式,获取一个ref数组。

示例代码如下:

<template>
  <div class="box">
    <div v-for="item in 10" :key="item" :ref="setBoxRef">
      box
    </div>
  </div>
</template>

<script lang="ts" setup>
import { onMounted, ref } from 'vue';

const boxRefs = ref<HTMLElement[]>([])
const setBoxRef = (el: any) => {
  if (el) {
    boxRefs.value.push(el)
  }
}

onMounted(() => {
  console.log(boxRefs.value)
})
</script>

在Vue3中获取DOM元素有多种方式,具体取决于使用场景。

情况三:获取ref中的ref

在Vue3中,无法像Vue2那样通过refs.refs或.children的方式获取嵌套的ref,因为这些方法已不再适用。

要解决这个问题,需要借助Vue3提供的新方法getCurrentInstance。

需要注意的是,getCurrentInstance只能在setup或者生命周期中使用才有效。

具体参考官方文档:https://v3.cn.vuejs.org/api/composition-api.html#getcurrentinstance

示例代码如下:

<template>
  <div class="box" ref="boxRef">
    <div ref="boxInnerRef">
      <div ref="innerRef">
        innerRef
      </div>
    </div>
  </div>
</template>

<script lang="ts" setup>
import { onMounted, getCurrentInstance } from 'vue';
onMounted(() => {
  const instance = getCurrentInstance()
  if (instance) {
    console.log(instance.refs)
  }
})
</script>

在Vue3中获取DOM元素有多种方式,具体取决于使用场景。

我们可以看到,不管多少层的ref,Vue3都给处理成了一层的Object形式,我们就能很方便的拿到自己需要的dom元素了

以上为个人经验,希望能给大家一个参考,也希望大家多多支持本站。

作者最新文章