诉诸 Vue 组合式 API 解构 Props

开发 前端
读写 props​ 对象时,我们要做的第一件事可能是,解构 props​ 对象,然后读写各个属性。但当我学习 Vue 组合式 API 时,令我大吃一惊的是,解构的 props 丢失了响应性!

大家好,这里是大家的林语冰。

响应式 API 赋予了组合式 API 一大坨可能性的同时,代码精简。虽然但是,我们应该意识到响应性的某些陷阱,比如丢失响应性。

在本文中,我们将学习如何正确解构 Vue 组件的 props,使得 props 不会丢失响应性。

1. 解构 props

编译器宏 defineProps() 可以辅助读写提供给 <script setup> 中的组件的 props:

图片图片

上述示例中,props 是一个响应式对象,包含了提供给组件的 props。如果组件 props 变化了,props 响应式对象也会随之变化。

读写 props 对象时,我们要做的第一件事可能是,解构 props 对象,然后读写各个属性。但当我学习 Vue 组合式 API 时,令我大吃一惊的是,解构的 props 丢失了响应性!

让我们来看一个例子。下述组件 <EvenOdd :count="5"> 接受 count 属性作为数字,并显示一条消息,无论 count 是偶数还是奇数。

在解构 props 对象 const { count } = defineProps() 之后,访问该 count 属性:

图片图片

单击几次增加按钮。您会注意到,尽管 count 属性不断累加,但 "The number is even" 消息始终保持不变。

当解构 props 对象 const { count } = defineProps() 时,响应性就会丢失。

响应性之所以会丢失,是因为在解构时 count 变异为具有原始值的变量(一个平平无奇的数字罢了)。但 Vue 的响应性不能直接作用于原始值:Vue 必须诉诸 ref 或响应式对象。

粉丝请注意,在 Vue 中将原始值直接赋值给变量时要小心:此乃丢失响应性的前提。

2. 解决方案 1:使用“props”对象

第一个显而易见的解决方案是,不要解构 props 对象,并使用属性读写器直接读写 props: props.count。

图片图片

上述示例中,读写 computed() 内的 props.count 可以在 props.count 变更时保留响应性。props 对象是响应式的,对其进行任何变更都会被正确追踪。

这种方案的短板是,我们必须始终使用属性读写器(比如 props.count)来读写 <script setup 中的 prop。

解决方案 2:使用 toRefs() 辅助函数

如果您阅读至此,我敢打赌您是解构赋值的忠实粉丝,并且没有它就活不下去。

问题不大,那么您可以有意识地将 props 对象的每个属性转换为 ref,来保留解构 props 的响应性。Vue 提供了一个特殊的辅助函数 toRefs(reactiveObject) 来精准完成此操作。

其工作机制如下:

图片图片

toRefs(props) 返回一个对象,其中每个属性都是对相应 prop 的 ref。

现在解构 const { count } = toRefs(props) 是安全的,因为 count 是基于 count 属性的 ref。现在,每次 count 属性变更时,count 的 ref 都会响应属性更改。

将 count 作为 ref,在 computed() 内,我们必须使用 count.value 读写 prop 的值(因为 count.value 是我们读写 ref 的值的方式)。

我发现此方案可以方便地将 prop ref 作为参数传递给组合式函数:比如 useMyComposable(count),并且不会丢失响应性。

否则,我会坚持之前的方案,直接使用 props 对象读写 prop。

4. 总结一下

粉丝请注意,通过应用解构 const { propA, propB } = defineProps(),我们会丢失 props 的响应性。

解决响应性丢失的方案主要有两种:

不解构 props,而是诉诸属性读写器直接读写 props:比如 props.xxx/props.cat。

有意识地使用 props 作为 refs 的对象:const { propA, propB } = toRefs(props)。这保留了解构后的响应性。然后我们可以将属性作为独立 ref 读写,比如 propsA.value/propB.value 等。

责任编辑:武晓燕 来源: 人猫神话
相关推荐

2022-06-13 08:39:21

Vue3API

2024-06-20 13:50:53

Vue 3API开发

2023-04-19 08:12:00

VueAPI组合式

2022-03-24 15:28:43

Vue开发框架

2022-03-11 12:31:04

Vue3组件前端

2020-07-10 11:30:29

组合式架构传统存储存储

2015-01-28 09:59:00

IBM混合云

2017-11-02 08:44:50

组合式存储架构

2024-06-25 12:20:31

2022-02-22 07:37:26

VuePinia态管理库

2022-06-21 12:09:18

Vue差异

2021-12-15 08:23:42

Vue3 插件Vue应用

2021-12-01 08:11:44

Vue3 插件Vue应用

2020-12-01 08:34:31

Vue3组件实践

2021-12-02 05:50:35

Vue3 插件Vue应用

2024-05-15 09:15:34

Vue环境3D

2021-08-25 08:00:00

人工智能机器学习技术

2020-10-20 09:51:51

Vue 3 的组合

2020-10-20 09:30:13

Vue 3 API 数据
点赞
收藏

51CTO技术栈公众号