• Vue 改进了响应式 API 中 getter 的用法
  • 发布于 2个月前
  • 311 热度
    0 评论
近日,Vue 改进了响应式 API 中 getter 的用法,主要包括:
1.一个用于将不同来源(value / ref / getter)规范化为值的 API(通过引入 toValue())
2.一个用于将不同来源(value / ref / getter)规范化为引用的 API(通过增强 toRef())
3.引入 MaybeRef<T> 和 MaybeRefOrGetter<T> 类型
通常需要将状态传递到组合式函数中并保持响应性。在大多数情况下,这意味着要将响应源转换为 ref:
import { toRef } from 'vue'
const props = defineProps(/* ... */)
useFeature(toRef(props, 'foo'))
目前,toRef 仅用于从对象中“提取”单个属性。这就有点不灵活,例如,如果想将嵌套属性转换为 ref:
useFeature(toRef(props.foo, 'bar'))
上面的代码有两个问题:
1.调用 toRef 时 props.foo 可能不存在
2.如果 props.foo 被交换到不同的对象,这将无法处理这种情况。
为了解决这个问题,可以使用 computed:
useFeature(computed(() => props.foo?.bar))
但是,在这里使用 computed 并不是最佳选择。在内部,computed 创建一个单独的 effect 来缓存计算值。当 getter 只访问属性而不执行任何昂贵的计算时,这实际上是很大的开销。将非引用响应状态传递到组合式函数的成本最低的方法就是用 getter 包装它(或“thunking”——即延迟实际值的访问,直到调用 getter):
useFeature(() => props.foo?.bar)
VueUse 已经广泛支持这种模式,这也有点类似于在 Solid 中看到的函数式 signals(信号)。此外,这种模式在使用响应式 props 解构时会很常用:
const { foo } = defineProps<{ foo: string }>()
useFeature(() => foo)

引入 toValue()
在组合式函数中,其参数可以接受值或引用。这可以表示为:
type MaybeRef<T> = T | Ref<T>
为了也支持 getters,接受的类型将是:
type MaybeRefOrGetter<T> = MaybeRef<T> | (() => T)
目前提供的unref将 MaybeRef<T> 规范化为 T。但是,不能让 unref 也解包 getter,因为这将是一个破坏性的变化。可以在函数值上调用 unref 并期望返回该函数。这种情况比较少见,但仍然是无法破解的可能情况。

因此,引入一个新方法,toValue():
export function toValue<T>(source: MaybeRefOrGetter<T>): T {
  return isFunction(source) ? source() : unref(source)
}
这就相当于 VueUse 的 [resolveUnref()](https://vueuse.org/shared/resolveUnref/)。这里将其命名为 toValue() 是因为它与 toRef() 相反:两者代表两个不同的规范化方向:
ref <- toRef() - ref/value/getter - toValue() -> value
增强 toRef()
当然也可能存在需要 ref 的情况——不能传递 getter。对于这种情况,仍然可以使用 computed。但如前所述,computed 对于只访问属性的简单 getter 来说是一种矫枉过正。可以向 toRef() 添加新的重载,以便它现在可以接受 getters :
const ref = toRef(() => 123)
ref.value // 123
以这种方式创建的 ref 是只读的,只是在每次访问 .value 时调用 getter。
toRef() 现在应该被视为“将 value / ref / getter 规范化为 refs” 的 API:
// value -> Ref
toRef(1) // Ref<number>
// Ref -> Ref
toRef(ref(1)) // Ref<number>
// getter -> Ref
toRef(() => 1) // Ref<number>
这就相当于 VueUse 的 [resolveRef()](https://vueuse.org/shared/resolveRef/)。
现在仍然支持旧的 toRef(object, 'key') 用法,但应该首选更灵活的 getter 语法:
toRef(() => object.key)

向后移植到 v2.7?
将这些功能添加在 v3.3 和 v2.7 之间造成了差异——虽然理论上不再回向 v2.7 添加新的功能,但这些可能值得向后移植以确保 vue-demi 和依赖于 vue-demi 的 VueUse 的行为一致性。

如果向后移植到 2.7,VueUse 也可以用 toRef 和 toValue 来替换 resolveRef 和 resolveUnref。
用户评论