模板引用
虽然 Vue 的声明性渲染模型为你抽象了大部分对 DOM 的直接操作,但在某些情况下,我们仍然需要直接访问底层 DOM 元素。要实现这一点,我们可以使用特殊的 ref
attribute:
template
<input ref="input">
ref
是一个特殊的 attribute,和 v-for
章节中提到的 key
类似。它允许我们在一个特定的 DOM 元素或子组件实例被挂载后,获得对它的直接引用。这可能很有用,比如说在组件挂载时将焦点设置到一个 input 元素上,或在一个元素上初始化一个第三方库。
访问模板引用
要在组合式 API 中获取引用,我们可以使用辅助函数 useTemplateRef() :
vue
<script setup>
import { useTemplateRef, onMounted } from 'vue'
// 第一个参数必须与模板中的 ref 值匹配
const input = useTemplateRef('my-input')
onMounted(() => {
input.value.focus()
})
</script>
<template>
<input ref="my-input" />
</template>
在使用 TypeScript 时,Vue 的 IDE 支持和 vue-tsc
将根据匹配的 ref
attribute 所用的元素或组件自动推断 input.value
的类型。
3.5 前的用法
在 3.5 之前的版本尚未引入 useTemplateRef()
,我们需要声明一个与模板里 ref attribute 匹配的引用:
vue