深入理解 Vue 3 的 Composition API 与新特性

简介: 本文详细探讨了 Vue 3 中的 Composition API,包括 setup 函数的使用、响应式数据管理(ref、reactive、toRefs 和 toRef)、侦听器(watch 和 watchEffect)以及计算属性(computed)。我们还介绍了自定义 Hooks 的创建与使用,分析了 Vue 2 与 Vue 3 在响应式系统上的重要区别,并概述了组件生命周期钩子、Fragments、Teleport 和 Suspense 等新特性。通过这些内容,读者将能更深入地理解 Vue 3 的设计理念及其在构建现代前端应用中的优势。

Composition API

setup

setup函数是Composition API(组合API)的入口。

setup执行时机是在beforeCreate之前执行。

setup函数中定义的变量和方法最后都是需要return出去的,不然无法在模板中使用。

setup里面是不会用到this的。

setup中接收的props是响应式的,当传入新的props时,会及时被更新。由于是响应式的,所以不可以使用ES6解构,解构会消除它的响应式的。setup接收的context中提供了最常用的四个属性:attrsslotemit,分别对应Vue@2.x中的$attr属性、slot插槽、$emit发射事件和expose暴露标记。并且这四个属性都是自动同步最新的值,所以我们每次使用拿到的都是最新值。

expose:在传统的写法中,可以在父组件中,通过ref实例的方式去访问子组件的内容,但在<script setup>中,setup相当于一个闭包,除了内部的template模板,都无法访问内部的数据和方法。如果需要对外暴露setup中的数据和方法,需要使用此属性。

<template>
   <h1>App</h1>
   <h2>{
  { age }}</h2>
</template>
<script>
import { defineComponent, ref } from "vue"
export default defineComponent({
  name: 'App',
  props: {
    name: String
  },
  setup(props, context) {
    let age = ref(18)
    function say() {
      console.log(`我${age.value}`)
    }
    //返回一个对象
    return {
      age,
      say
    }
  }
})
</script>

如果上面这种return的写法不喜欢的话,可以用新的语法糖<script setup><script setup>就相当于在编译运行时把代码放到setup函数中运行,然后把导出的变量定义到上下文中,并包含在返回的对象中。

<script setup>中,引入的组件可以直接使用,无需再通过components进行注册,并且无法指定当前组件的名字,它会自动以文件名为主,也就无需再写name属性。

使用props

通过defineProps指定当前props类型,获得上下文的props对象。

使用emits

使用defineEmits定义当前组件含有的事件,并通过返回的上下文去执行emit

使用slotsattrs

<script setup>中使用slotsattrs,分别使用useSlotsuseAttrs帮助函数。

使用expose

使用defineExpose暴露需要对外的数据和方法。

<template>
   <Child />
</template>
<script setup>
import Child from './Child.vue'
import { ref, defineEmits, defineExpose, defineProps, useSlots, useAttrs } from 'vue'

let age = ref(18)
const props = defineProps({
  name: String
})
const emits = defineEmits(['add', 'delete')
const slots = useSlots()
const attrs = useAttrs()
defineExpose({
    age,
    say
})
const say = () => {
  console.log(`我${age.value}`)
}
</script>

Vue@2.6.x开始,Vue 为具名和范围插槽引入了一个全新的语法,即v-slot 指令。目的就是想统一 slotscope-slot 语法,使代码更加规范和清晰。在 vue@3.x中,只能使用v-slot

reactivereftoRefstoRef

vue@3.x使用reactiveref来进行响应式数据定义。

ref

使用ref定义的变量变成了对象,并且还是RefImpl的实例对象。所以在修改的时候要用.value去修改,因为内部是按照getset去修改页面的。但是在template中就不用自己手动添加.value,因为vue@3.x在检测到是ref对象,就自动添加了.value。如果用ref定义对象,则不再是RefImpl实例对象,变成了Proxy实例对象,因为在vue@3.x底层,如果是对象,就变成Proxy实例对象,对于基本数据类型就按照Object.defineProperty里面的getset进行数据劫持然后进行响应式,但是如果是对象类型的话,是用Proxy,就相当于,ref中是对象,自动会调用reactive

reactive

reactive只能定义对象类型的响应式数据,把Object转换为Proxy,进行一个深层次的响应式,也可以进行数组的响应式。

refreactive的区别

  • ref用来定义基本数据类型,也可以定义对象或数组,知识内部自动调用了reactive来转换。
  • ref通过Object.defineProperty()getset来实现响应式(数据劫持)。
  • ref定义的数据:操作数据需要.value,读取数据时模板中直接读取不需要.value
  • reactive用来定义:对象或数组类型数据
  • reactive通过使用Proxy来实现响应式(数据代理),并通过Reflect操作源代码内部的数据。
  • reactive定义的数据:操作和读取数据均不需要.value

toRefs

toRefs用于将一个reactive对象转化为属性全部为ref对象的普通对象。

toRef

ToRef用于将一个reactive对象里面的单个属性转化为ref对象的普通对象。而且它既保留了响应式,也保留了引用,也就是说从reactive复制过来的属性进行修改后,除了视图会更新,原有reactive里面对应的值也会跟着更新。

template访问toRefs的值,需要带上.value,如果不带,就会出现双引号。

template访问toRef的值,不需要带上.value

<template>
  <p>第 {
  { year }} 年</p>
  <p>姓名: {
  { nickname }}</p>
  <p>姓名修改:{
  { refsUser.nickname.value }}</p>
  <p>年龄: {
  { age }}</p>
  <p>姓名修改:{
  {toRefNickName}}</p>
  <div>----------------------------</div>
  <p>人名:{
  { personName }}</p>
  <p>人性别:{
  { personGender }}</p>
</template>

<script setup>
import { reactive, ref, toRefs, toRef } from "vue"
const year = ref(0)
/**
 * reactive、ref定义和修改对象的区别
 */
// 使用reactive定义对象
const user = reactive({
  nickname: "xiaofan",
  age: 26,
  gender: "女"
})
const {nickname, age} = toRefs(user)
const refsUser = toRefs(user)
const toRefNickName = toRef(user, 'nickname')
setTimeout(() => {
  user.gender = "男"
  refsUser.nickname.value = '小明'
  // toRefNickName.value = 'Janna'
}, 1000)
// 使用ref定义对象
const person = ref({
  personName: "James",
  personAge: 27,
  personGender: "男"
})
const {personName, personGender} = toRefs(person.value)
setTimeout(() => {
  person.value.personGender = "女"
}, 1000)

</script>

watchwatchEffectcomputed

watch

watch函数用来侦听特定的数据源,并执行回调函数。默认情况下是惰性的,也就是说仅在侦听的源数据变更时才执行回调。

watch(source, callback, [options])

参数说明:

  • source:可以支持StringObjectFunctionArray,用于指定要侦听的响应式变量。
  • callback:执行的回调函数。
  • options:支持deepimmediateflush选项。
<template>
  <p>姓名: {
  { nickname }}</p>
  <p>世纪:{
  { year }}</p>
</template>

<script setup>
import { reactive, toRefs, watch, ref } from "vue"
const year = ref(1000)
const user = reactive({
  nickname: "xiaofan",
  age: 26,
  gender: "女"
})
const { nickname } = toRefs(user)
setTimeout(() => {
  nickname.value = "James"
  year.value = 2022
}, 1000)
// 侦听reactive定义的数据
watch(nickname, (newVal, oldVal) => {
  console.log('newVal:', newVal, 'oldVal', oldVal)
})
watch(() => user.nickname, (newVal, oldVal) => {
  console.log('newVal:', newVal, 'oldVal', oldVal)
})
// 侦听ref定义的数据
watch(year, (newVal, oldVal) => {
  console.log('newVal:', newVal, 'oldVal', oldVal)
})
// 侦听多个数据
watch([year, () => user.nickname], ([yearNewVal, nickNewVal], [yearOldVal, nickOldVal]) => {
  console.log('yearNewVal:', yearNewVal, 'nickNewVal', nickNewVal)
  console.log('yearOldVal:', yearOldVal, 'nickOldVal', nickOldVal)
})
// 侦听复杂的嵌套对象
/**
 * 第三个参数:
 *  deep: true,表示深度侦听
 *  immediate: true,表示立即触发一次侦听
 */
const room = reactive({
  id: 100,
  attrs: {
    size: "140平方米",
    type: "三室两厅"
  },
})
setTimeout(() => {
  room.attrs.size = "200平方米"
}, 2000)
watch(() => room.attrs, (newVal, oldVal) => {
  console.log('侦听复杂的嵌套对象', 'newVal:', newVal, 'oldVal', oldVal)
}, {
  deep: true
})

</script>

在监听reactive定义的响应式数据时,oldVal无法正确获取,并且强制开启深度监听(deep: true),并且无法关闭。

stop停止监听

在组件中创建的watch监听,会在组件被销毁时自动停止。如果在组件销毁之前想要停止某个监听,可以调用watch()函数的返回值。

<template>
  <p>姓名: {
  { nickname }}</p>
</template>

<script setup>
import { reactive, toRefs, watch } from "vue"
const user = reactive({
  nickname: "xiaofan",
  age: 26,
  gender: "女"
})
const { nickname } = toRefs(user)
setInterval(() => {
  nickname.value += "James"
}, 2000)
const stopWatchNick = watch(nickname, (newVal, oldVal) => {
  console.log('newVal:', newVal, 'oldVal', oldVal)
})
// stop停止监听
setTimeout(() => {
  stopWatchNick()
}, 7000)

</script>

watchEffect

watchEffectvue@3.x的新函数,它会自动收集依赖,只要指定一个回调函数。在组件初始化时,会先执行一次来收集依赖,然后当收集到的依赖中数据发生变化时,就会再次执行回调函数。

  • watchEffect不需要手动传入依赖
  • watchEffect会先执行一次用来自动收集依赖(自动默认开启:immediate: true
  • watchEffect无法获取到变化前的值,只能获取到变化后的值
<template>
  <h3>{
  {name}}</h3>
  <h3>{
  {year}}</h3>
</template>
<script setup>
import { watchEffect, reactive, toRefs, ref } from 'vue';
const year = ref(2022)
const obj = reactive({
  name: 'James',
  age: 18
})
setInterval(() => {
  obj.name = 'James' + Math.random();
  year.value = 2020 + Math.random() * 10;
}, 1000)
watchEffect(() => {
  console.log(obj.name);
})
const {name} = toRefs(obj)
</script>

computed

<template>
 <input type="text" placeholder="请输入姓" v-model="user.familyName" />
 <input type="text" placeholder="请输入名" v-model="user.lastName" />
 <h3>姓名:{
  {fullName}}</h3>
</template>
<script setup>
import { reactive, computed } from 'vue';
const user = reactive({
  familyName: '',
  lastName: ''
})
const fullName = computed(() => {
  return `${user.familyName} ${user.lastName}`
})
</script>

自定义Hooks

vue@3.x中的自定义Hooks函数相当于vue@2.x中的mixin,不同的是hooks是函数;它可以帮助我们提高代码的复用性,让我们能在不同的组件中都利用hooks函数。一般约定自定义Hooksuse作为前缀,和普通函数加以区分。

import {
    computed, ref } from "vue"
const useCount = (initValue = 1) => {
   
    const count = ref(initValue)
    const multiple = computed(() => count.value * 2)
    const increase = () => count.value++
    const decrease = () => count.value--
    return {
   
        count,
        multiple,
        increase,
        decrease
    }
}
export default useCount
<template>
  <h3>{
  {count}}</h3>
  <h3>{
  {multiple}}</h3>
  <button @click="increase">加</button>
  <button @click="decrease">减</button>
</template>
<script setup>
import useCount from '@/hooks/useCount';
const { count, multiple, increase, decrease } = useCount(100);
</script>

vue@2.xvue@3.x响应式对比

vue@3.xProxy --- vue@2.xObject.defineProperty

  • Object.defineProperty只能劫持对象的属性,而Proxy是直接代理对象。

    由于Object.defineProperty只能劫持对象属性,需要遍历对象的每一个属性,如果属性值也是对象,就需要递归进行深度遍历。但是Proxy直接代理对象,不需要遍历操作。

  • Object.defineProperty对新增属性需要手动进行Observe

    因为Object.defineProperty劫持的是对象的属性,所以新增属性时,需要重新遍历对象,对其新增属性再次使用Object.defineProperty进行劫持。也就是vue@2.x中给数组和对象新增属性时,需要使用$set才能保证新增的属性也是响应式的,$set内部也是通过调用Object.defineProperty去处理的。

生命周期钩子

vue3生命周期

vue2与vue3生命周期对比

在某个组件被<keep-alive>标签包裹时,第一次显示该组件,会触发setup()onActivated。在第二次显示该组件时,由于从缓存中调取的,所以不会再次触发setup(),只会触发onActivated

在切换为其他组件时由于<keep-alive>包裹缓存,所以不会触发onBeforeUnmountonUnmounted而触发了onDeactivated

onRenderTracked它会跟踪页面上所有响应式变量和方法的状态。只要页面由update的情况,它就会跟踪,然后生成一个event对象,我们通过event对象来查找程序的问题所在。

inRenderTriggered他不会跟踪每一个值,而是给你变量值的信息,并且信值和旧值都会给你明确的展示出来。生成的event对象其中包含key(哪边变量发生了变化)、newValue(更新后变量的值)、oldValue(更新前变量的值)和target(目前页面中的响应变量和函数)。

onErrorCaptured它会捕获子孙组件的异常报错,可以在这个函数中自定义处理错误信息。如果onErrorCaptured钩子自身抛出了一个错误,那么这个新的错误和原本捕获到的错误都会发送给全局的config.errorHandle

Fragment(碎片、片段)

作为Vue@3.x的新特性之一,它的意思就相当于创建页面时,自动创建个虚拟根标签VNode,所以可以不要根标签,也就是说允许一个Vue组件可以有多个根节点。好处就是减少标签层级,减小内存占用

<!-- Layout.vue -->
<template>
  <header>...</header>
  <main v-bind="$attrs">...</main>
  <footer>...</footer>
</template>

Teleport

即希望继续在组件内部使用,又希望渲染的DOM结构不嵌套在组件的DOM中。

可以定义teleport在任意标签里进行定位等(常见操作为模态框),除了body,还可以写css选择器(idclass)。

to属性与需要绑定的选择器保持一致。

<template>
  <teleport to="#app">
    <div class="dialog">
      直接定位在顶级#app选择器上
    </div>
  </teleport>
</template>
<script setup>
import { ref } from 'vue';
const title = ref('标题');
</script>

Suspense

Suspense是一个特殊组件,它会有两个template slot,刚开始会渲染feedback内容,知道达到某个条件以后,才会渲染正式的内容,也就是default的内容。如果使用Suspense,要返回一个promise而不是一个对象。

目录
相关文章
|
17天前
|
JavaScript 前端开发 API
Vue 3新特性详解:Composition API的威力
【10月更文挑战第25天】Vue 3 引入的 Composition API 是一组用于组织和复用组件逻辑的新 API。相比 Options API,它提供了更灵活的结构,便于逻辑复用和代码组织,特别适合复杂组件。本文将探讨 Composition API 的优势,并通过示例代码展示其基本用法,帮助开发者更好地理解和应用这一强大工具。
20 1
|
22天前
|
API
《vue3第四章》Composition API 的优势,包含Options API 存在的问题、Composition API 的优势
《vue3第四章》Composition API 的优势,包含Options API 存在的问题、Composition API 的优势
25 0
|
22天前
|
JavaScript 前端开发 API
《vue3第六章》其他,包含:全局API的转移、其他改变
《vue3第六章》其他,包含:全局API的转移、其他改变
20 0
|
4天前
|
JSON API 数据格式
淘宝 / 天猫官方商品 / 订单订单 API 接口丨商品上传接口对接步骤
要对接淘宝/天猫官方商品或订单API,需先注册淘宝开放平台账号,创建应用获取App Key和App Secret。之后,详细阅读API文档,了解接口功能及权限要求,编写认证、构建请求、发送请求和处理响应的代码。最后,在沙箱环境中测试与调试,确保API调用的正确性和稳定性。
|
16天前
|
供应链 数据挖掘 API
电商API接口介绍——sku接口概述
商品SKU(Stock Keeping Unit)接口是电商API接口中的一种,专门用于获取商品的SKU信息。SKU是库存量单位,用于区分同一商品的不同规格、颜色、尺寸等属性。通过商品SKU接口,开发者可以获取商品的SKU列表、SKU属性、库存数量等详细信息。
|
17天前
|
JSON API 数据格式
店铺所有商品列表接口json数据格式示例(API接口)
当然,以下是一个示例的JSON数据格式,用于表示一个店铺所有商品列表的API接口响应
|
27天前
|
编解码 监控 API
直播源怎么调用api接口
调用直播源的API接口涉及开通服务、添加域名、获取API密钥、调用API接口、生成推流和拉流地址、配置直播源、开始直播、监控管理及停止直播等步骤。不同云服务平台的具体操作略有差异,但整体流程简单易懂。
|
7天前
|
JSON API 数据安全/隐私保护
拍立淘按图搜索API接口返回数据的JSON格式示例
拍立淘按图搜索API接口允许用户通过上传图片来搜索相似的商品,该接口返回的通常是一个JSON格式的响应,其中包含了与上传图片相似的商品信息。以下是一个基于淘宝平台的拍立淘按图搜索API接口返回数据的JSON格式示例,同时提供对其关键字段的解释
|
1月前
|
人工智能 自然语言处理 PyTorch
Text2Video Huggingface Pipeline 文生视频接口和文生视频论文API
文生视频是AI领域热点,很多文生视频的大模型都是基于 Huggingface的 diffusers的text to video的pipeline来开发。国内外也有非常多的优秀产品如Runway AI、Pika AI 、可灵King AI、通义千问、智谱的文生视频模型等等。为了方便调用,这篇博客也尝试了使用 PyPI的text2video的python库的Wrapper类进行调用,下面会给大家介绍一下Huggingface Text to Video Pipeline的调用方式以及使用通用的text2video的python库调用方式。
|
17天前
|
JSON 前端开发 JavaScript
API接口商品详情接口数据解析
商品详情接口通常用于提供特定商品的详细信息,这些信息比商品列表接口中的信息更加详细和全面。以下是一个示例的JSON数据格式,用于表示一个商品详情API接口的响应。这个示例假定API返回一个包含商品详细信息的对象。