【VUE3分步学】:模板引用

130 阅读1分钟

持续创作,加速成长!这是我参与「掘金日新计划 · 10 月更文挑战」的第1天,点击查看活动详情

为了方便直接访问底层 DOM 元素,我们可以使用 ref 来实现。

它允许我们在一个特定的 DOM 元素或子组件实例被挂载(onMounted)之后,直接引用。

<script setup>
import { ref, onMounted } from 'vue'// 声明一个 ref 来存放该元素的引用
// 必须和模板里的 ref 同名
const input = ref(null)
​
onMounted(() => {
  input.value.focus()
})
</script><template>
  <input ref="input" />
</template>

侦听模板引用 ref 变化

watchEffect(() => {
  if (input.value) {
    input.value.focus()
  } else {
    // 此时还未挂载,或此元素已经被卸载(例如通过 v-if 控制)
  }
})

为模板引用标注类型

模板引用需要通过一个显示指定的泛型参数和一个初始值 null 来创建:

<script setup lang="ts">
import { ref, onMounted } from 'vue'const el = ref<HTMLInputElement | null>(null)
​
onMounted(() => {
  el.value?.focus()
})
</script><template>
  <input ref="el" />
</template>

注意为了严格的类型安全,有必要在访问 el.value 时使用可选链或类型守卫。这是因为直到组件被挂载前,这个 ref 的值都是初始的 null,并且在由于 v-if 的行为将引用的元素卸载时也可以被设置为 null

v-for 中的模板引用

对应的 ref 中包含的值是一个数组,它将在元素被挂载之后包含对应整个列表的所有元素。

<script setup>
import { ref, onMounted } from 'vue'const list = ref([
  /* ... */
])
​
const itemRefs = ref([])
​
onMounted(() => console.log(itemRefs.value))
</script><template>
  <ul>
    <li v-for="item in list" ref="itemRefs">
      {{ item }}
    </li>
  </ul>
</template>

注意:ref 数组于源数组顺序不一定相同。

组件上的 ref

此时 ref 获取的值是组件的实例.

<script setup>
import { ref, onMounted } from 'vue'
import Child from './Child.vue'const child = ref(null)
​
onMounted(() => {
  // child.value 是 <Child /> 组件的实例
})
</script><template>
  <Child ref="child" />
</template>

如果一个子组件使用的是选项式 API 或没有使用 <script setup>,被引用的组件实例和该子组件的 this 完全一致,这意味着父组件对子组件的每一个属性和方法都有完全的访问权。

使用了 <script setup> 的组件是默认私有的:一个父组件无法访问到一个使用了 <script setup> 的子组件中的任何东西,除非子组件在其中通过 defineExpose 宏显式暴露:

<script setup>
import { ref } from 'vue'

const a = 1
const b = ref(2)

defineExpose({
  a,
  b
})
</script>