用途:这是 TanStack DB 的 Vue 3 绑定,建立在 db-core 之上,需先阅读 db-core 了解集合设置、查询构建器与变更模式。@tanstack/vue-db 重新导出 @tanstack/db 的全部内容。
主要能力:核心是 useLiveQuery 组合式函数,返回值(data、isLoading、isReady、status 等字段)均为 ComputedRef;查询函数支持 MaybeRefOrGetter,可传入响应式依赖数组,依赖变化时查询重跑。支持配置对象写法(含 gcTime 等)、直接传入预先创建的集合、以及返回 undefined 的条件查询。Vue 特定模式包括在 ref 中携带响应式依赖、在事件处理器中调用集合 update 执行变更。includes 层级查询默认每个子字段是实时 Collection,可在子组件中用 useLiveQuery 订阅;使用 toArray() 时子结果为普通数组,父级会在子变更时重新发射。
使用方式:在 <script setup> 中从 @tanstack/vue-db 导入 useLiveQuery 及 eq、not、gt、toArray 等。
限制与常见错误:查询中使用的响应式 ref 必须列入依赖数组,否则不会重新执行。includes 的完整规则(关联条件、嵌套 includes、聚合)见 db-core live-queries 技能,变更模式见 mutations-optimistic 技能。其余细节暂未提供。