用途:vue-db 是 TanStack DB 面向 Vue 3 的官方绑定,用于在 Vue 组件中订阅实时查询数据。它建立在 db-core 之上,需要先阅读 db-core 了解集合(collection)设置、查询构建器与变更模式。
主要能力:提供 useLiveQuery 组合式函数,其所有返回值(data、isLoading、isReady、status 等)均为 ComputedRef。它从 @tanstack/vue-db 导入,该包同时重新导出 @tanstack/db 的全部内容。支持查询函数配合响应式依赖数组,例如传入 [minPriority] 或 [filter],当依赖变化时查询自动重新运行。也可传入配置对象(含 query、gcTime 等),或传入已有的 collection(含预先加载的 collection,通过 ref 响应式)。支持条件查询:当条件不满足时查询函数返回 undefined。变更可在事件处理器中直接调用 collection 方法,如 todoCollection.update(id, (draft) => { draft.completed = !draft.completed })。
includes(层级数据):查询使用 includes 时,默认每个子字段是一个实时 Collection,可在子组件中用 useLiveQuery 订阅;若使用 toArray(),子结果为普通数组,父组件会在子数据变化时重新触发,无需子组件。详细 includes 规则见 db-core/live-queries。
常见错误:在查询中使用的响应式 ref 必须加入依赖数组,否则依赖变化时查询不会重新运行。
限制与未提供信息:官方资料未提供收费、价格、平台兼容性、性能数据或具体版本要求,暂未提供。