vue3-模版引用

模版引用

ref 属性

场景:需要直接访问底层 DOM 元素。

方法:使用特殊的 ref 属性。

复制代码
<input ref="input">

ref 属性 允许我们在一个特定的 DOM 元素或子组件实例被挂载后,获得对它的直接引用。

访问模板引用

小 Demo: 当 input 组件挂载后 自动获取焦点

复制代码
<script lang="ts" setup>
import { ref, onMounted } from 'vue'

// 声明一个 ref 来存放该元素的引用
// 必须和模板里的 ref 同名
const input = ref(null)

onMounted(() => {
  input.value.focus()
})

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

<template>
  <div class="container">
    <input ref="input" />
  </div>
</template>

<style lang="scss" scoped>
.container {
}
</style>

注意:只有组件挂载后才能访问模版引用。初次渲染时元素不存在所以在模版表达式上访问变量则为 null。
如果你需要侦听一个模板引用 ref 的变化,确保考虑到其值为 null 的情况

v-for 中的模板引用

复制代码
<script lang="ts" setup>
import { ref, onMounted } from 'vue'

const list = ref([
  /* ... */
  1, 2, 3
])

const itemRefs = ref([])

onMounted(() => console.log(itemRefs.value))
</script>

<template>
  <div class="container">
    <ul>
      <li v-for="item in list" ref="itemRefs">
        {{ item }}
      </li>
    </ul>
  </div>
</template>

<style lang="scss" scoped>
.container {
}
</style>

效果:

应该注意的是,ref 数组并不保证与源数组相同的顺序。

函数模板引用

  1. 除了使用字符串作为名字,还可以使用一个函数,函数会在每次组件更新时都被调用。

  2. 该函数会收到元素引用作为其第一个参数

    <script lang="ts" setup> import { ref, onMounted } from 'vue'

    const input = ref([])

    const sum = (el) => {
    console.log(el)
    }
    </script>

    <template>
    <button :ref=" (el) => { console.log(el) } " > 绑定内联函数 </button>
    <button :ref="sum">绑定组件函数</button>
    </template> <style lang="scss" scoped> .container { } </style>

效果:

  • 语法是 :ref 绑定函数。

  • 可以绑定内联函数。

  • 可以绑定组件函数。

  • 当元素被销毁时,函数也会被调用一次,此时引用参数为 null。

组件上的 ref

模板引用也可以被用在一个子组件上。这种情况下引用中获得的值是组件实例

复制代码
<script lang="ts" setup>
import { onMounted, ref } from 'vue'
import ComA from '@/components/ComA.vue'

const coma = ref<InstanceType<typeof ComA>>()

onMounted(() => {
  console.log(coma.value)
})
</script>

<template>
  <div class="container">
    <ComA ref="coma"></ComA>
  </div>
</template>

<style lang="scss" scoped>
.container {
}
</style>

效果:

一个子组件使用的是选项式 API ,父组件对子组件的每一个属性和方法都有完全的访问权。
使用了 <script setup> 的组件是默认私有的,一个父组件无法访问到一个使用了 <script setup> 的子组件中的任何东西,除非子组件在其中通过 defineExpose 宏显式暴露

defineExpose 宏

复制代码
<script lang="ts" setup>
import { ref } from 'vue'

const a = ref(1)
const b = ref(2)

// 像 defineExpose 这样的编译器宏不需要导入
defineExpose({
  a,
  b
})
</script>

<template>
  <div class="container">我是子组件</div>
</template>

<style lang="scss" scoped>
.container {
}
</style>

未定义效果:

定义效果:

相关推荐
泯泷4 分钟前
「译」解析 JavaScript 中的循环依赖
前端·javascript·架构
抹茶san7 分钟前
前端实战:从 0 开始搭建 pnpm 单一仓库(1)
前端·架构
Senar34 分钟前
Web端选择本地文件的几种方式
前端·javascript·html
烛阴1 小时前
UV Coordinates & Uniforms -- OpenGL UV坐标和Uniform变量
前端·webgl
姑苏洛言1 小时前
扫码小程序实现仓库进销存管理中遇到的问题 setStorageSync 存储大小限制错误解决方案
前端·后端
烛阴1 小时前
JavaScript 的 8 大“阴间陷阱”,你绝对踩过!99% 程序员崩溃瞬间
前端·javascript·面试
lh_12542 小时前
ECharts 地图开发入门
前端·javascript·echarts
jjw_zyfx2 小时前
成熟的前端vue vite websocket,Django后端实现方案包含主动断开websocket连接的实现
前端·vue.js·websocket
Mikey_n2 小时前
前台调用接口的方式及速率对比
前端
周之鸥2 小时前
使用 Electron 打包可执行文件和资源:完整实战教程
前端·javascript·electron