Vue 3.0 组合式API 模板引用 【Vue3 从零开始】

本节代码示例使用单文件组件的语法

本指南假定你已经阅读了组合式 API 简介和响应性基础。如果你不熟悉组合式 API，请先阅读此文章。

在使用组合式 API 时，响应式引用和模板引用的概念是统一的。为了获得对模板内元素或组件实例的引用，我们可以像往常一样声明 ref 并从 setup() 返回：

1. <template>
2. <div ref="root">This is a root element</div>
3. </template>
6. <script>
7. import { ref, onMounted } from 'vue'
10. export default {
11. setup() {
12. const root = ref(null)
15. onMounted(() => {
16. // DOM元素将在初始渲染后分配给ref
17. console.log(root.value) // <div>这是根元素</div>
18. })
21. return {
22. root
23. }
24. }
25. }
26. </script>

这里我们在渲染上下文中暴露 root，并通过 ref="root"，将其绑定到 div 作为其 ref。在虚拟 DOM 补丁算法中，如果 VNode 的 ref 键对应于渲染上下文中的 ref，则 VNode 的相应元素或组件实例将被分配给该 ref 的值。这是在虚拟 DOM 挂载/打补丁过程中执行的，因此模板引用只会在初始渲染之后获得赋值。

作为模板使用的 ref 的行为与任何其他 ref 一样：它们是响应式的，可以传递到 (或从中返回) 复合函数中。

#JSX 中的用法

1. export default {
2. setup() {
3. const root = ref(null)
6. return () =>
7. h('div', {
8. ref: root
9. })
12. // with JSX
13. return () => <div ref={root} />
14. }
15. }

#v-for 中的用法

组合式 API 模板引用在 v-for 内部使用时没有特殊处理。相反，请使用函数引用执行自定义处理：

1. <template>
2. <div v-for="(item, i) in list" :ref="el => { if (el) divs[i] = el }">
3. {{ item }}
4. </div>
5. </template>
8. <script>
9. import { ref, reactive, onBeforeUpdate } from 'vue'
12. export default {
13. setup() {
14. const list = reactive([1, 2, 3])
15. const divs = ref([])
18. // 确保在每次更新之前重置ref
19. onBeforeUpdate(() => {
20. divs.value = []
21. })
24. return {
25. list,
26. divs
27. }
28. }
29. }
30. </script>