用途:为 SolidJS 应用提供 TanStack DB 的响应式实时查询绑定,需先阅读 db-core 了解集合、查询构建器与变更模式。@tanstack/solid-db 会重新导出 @tanstack/db 的全部内容。
主要能力:useLiveQuery 返回 Accessor<Array<T>>(使用 findOne 时为 Accessor<T | undefined>),调用它获取数据;附带 status、isLoading、isReady、isError、state(ReactiveMap)、collection 属性。支持传入查询函数、配置对象 Accessor 或预建集合 Accessor,也支持条件查询返回 undefined。
使用方式:信号必须在查询函数内部读取才能被追踪,例如在 where 中调用 minPriority();在外部读取会丢失追踪。findOne 返回单个对象或 undefined。与 Solid 的 createResource 集成,可包在 Suspense 中处理加载态。includes 子查询默认返回实时 Collection,可在子组件用 useLiveQuery 订阅;使用 toArray() 则子结果为普通数组,父级会在子变更时重新发出。
限制与注意:query.data 已废弃,应改用 query()。子 Collection 需包成 Accessor 以匹配重载签名。includes 的关联条件、嵌套与聚合规则见 db-core-live-queries 技能;变更模式见 db-core-mutations-optimistic 技能。官方文档来源为 docs/framework/solid/overview.md。