SuperAPI AI 工具集

create-adaptable-composable

通用与其它

查看项目

更新于 10-16 07:21

技能介绍

用途:该技能用于创建“库级”的 Vue 组合式函数(composable),使其输入既能接受普通值,也能接受 ref、shallowRef、可写 computed 或 getter,从而让调用方无需关心传入值的响应式形态。

主要能力与类型概念:提供 MaybeRef<T>(值或可写 ref,含 value/ref/shallowRef/writable computed)与 MaybeRefOrGetter<T>(MaybeRef 加 ComputedRef 与 () => T)两种类型工具,用于标注参数。

设计步骤:先确认 composable 的用途、API 设计及预期输入输出;识别哪些参数应支持响应式;在响应式副作用内用 toValue() 或 toRef() 归一化输入;再用 Vue 响应式 API 实现核心逻辑。

规则:只读、兼容 computed 的输入用 MaybeRefOrGetter;需要可写或双向输入用 MaybeRef;参数本身可能是函数值(回调、谓词、比较器)时不要用 MaybeRefOrGetter,否则可能被误当作 getter 调用;DOM/Element 目标若需 computed/派生目标则用 MaybeRefOrGetter。使用 MaybeRefOrGetter 或 MaybeRef 时,响应式值用 toRef() 解析(如 watcher 源),非响应式值用 toValue() 解析。

示例:useDocumentTitle(title: MaybeRefOrGetter<string>) 通过 watch(toRef(title), ...) 设置 document.title;useCounter(count: MaybeRef<number>) 通过 toRef(count) 实现可写计数并返回 add。

适用场景:编写可复用、面向库发布的 Vue composable,需要兼容普通值、ref 与 getter 的输入。限制:资料未提供安装命令、版本要求、收费或平台信息。