前言
Vue3相较于Vue3做了许多优化,语法上也有所改变。其中v-for循环生成组件上的ref写法变化很大,容易踩坑,特此记录。
ref定义
ref
是一个特殊的 attribute,和v-for
中的key
类似。它允许我们在一个特定的 DOM 元素或子组件实例被挂载后,获得对它的直接引用。
简单使用
为了通过组合式 API 获得该Dom,我们需要声明一个同名的 ref
<template>
<h4 ref="test">我是测试ref的元素</h4>
</template>
<script setup lang="ts">
import { ref } from 'vue'
// 声明一个 ref 来存放该元素的引用
// 必须和模板里的 ref 同名
const test = ref(null)
</script>
注意,只可以在组件挂载后才能访问模板引用。如果想在模板中的表达式上访问“test”,在初次渲染时会是 null
。这是因为在初次渲染前这个元素还不存在呢!
同理,如果需要侦听一个模板引用 ref 的变化,确保考虑到其值为 null
的情况:
watchEffect(() => {
if (test.value) {
...
} else {
// 此时还未挂载,或此元素已经被卸载(例如通过 v-if 控制)
}
})
v-for中的使用
当在 v-for
中使用模板引用时,对应的 ref 中包含的值是一个数组,它将在元素被挂载后包含对应整个列表的所有元素:
<script setup>
import { ref, onMounted } from 'vue'
// v-for 循环列表
const list = ref(['a', 'b', 'c'])
// 跟简单使用不同,不是null,而是一个空数组
const itemRefs = ref([])
onMounted(() => console.log(itemRefs.value))
</script>
<template>
<ul>
<li v-for="item in list" ref="itemRefs">
{
{ item }}
</li>
</ul>
</template>