安装

每个支持的框架都附带自己的包。每个框架包都会重新导出核心 @tanstack/db 包中的所有内容。

npm install @tanstack/react-db

npm install @tanstack/react-db

TanStack DB 兼容 React v16.8+

npm install @tanstack/solid-db

npm install @tanstack/solid-db

npm install @tanstack/svelte-db

npm install @tanstack/svelte-db

npm install @tanstack/vue-db

npm install @tanstack/vue-db

TanStack DB 兼容 Vue v3.3.0+

npm install @tanstack/db

npm install @tanstack/db

安装核心 @tanstack/db 包，即可在没有框架的情况下使用 DB。

TanStack DB 还提供了针对不同数据源和存储需求的专用集合包

用于使用 TanStack Query 加载数据

npm install @tanstack/query-db-collection

npm install @tanstack/query-db-collection

使用 queryCollectionOptions 通过 TanStack Query 将数据获取到集合中。这对于 REST API 和现有的 TanStack Query 设置非常理想。

框架包中包含了本地存储和内存集合

• LocalStorageCollection - 用于持久化本地数据，可在浏览器标签页之间同步
• LocalOnlyCollection - 用于临时内存数据和 UI 状态

两者分别使用 localStorageCollectionOptions 和 localOnlyCollectionOptions，可从您的框架包（例如 @tanstack/react-db）获取。

用于与 ElectricSQL 进行实时同步

npm install @tanstack/electric-db-collection

npm install @tanstack/electric-db-collection

使用 electricCollectionOptions 通过 ElectricSQL shapes 将数据从 Postgres 数据库同步。非常适合实时、本地优先的应用程序。

用于与 TrailBase 后端进行同步

npm install @tanstack/trailbase-db-collection

npm install @tanstack/trailbase-db-collection

使用 trailBaseCollectionOptions 通过 TrailBase 的 Record API 同步记录，并内置订阅支持。