模板引用

该页面假设你已经阅读过了组件基础。如果你还对组件不太了解,推荐你先阅读它。

尽管存在 prop 和事件,但有时你可能仍然需要直接访问 JavaScript 中的子组件。为此,可以使用 ref attribute 为子组件或 HTML 元素指定引用 ID。例如:

  1. <input ref="input" />

例如,你希望以编程的方式 focus 这个 input 在组件上挂载,这可能有用

  1. const app = Vue.createApp({})
  2. app.component('base-input', {
  3. template: `
  4. <input ref="input" />
  5. `,
  6. methods: {
  7. focusInput() {
  8. this.$refs.input.focus()
  9. }
  10. },
  11. mounted() {
  12. this.focusInput()
  13. }
  14. })

此外,还可以向组件本身添加另一个 ref,并使用它从父组件触发 focusInput 事件:

  1. <base-input ref="usernameInput"></base-input>
  1. this.$refs.usernameInput.focusInput()

refv-for 一起使用时,你得到的 ref 将是一个数组,其中包含镜像数据源的子组件。

WARNING

$refs 只会在组件渲染完成之后生效。这仅作为一个用于直接操作子元素的“逃生舱”——你应该避免在模板或计算属性中访问 $refs

参考在 Composition API 中使用 template refs