JotaiJotai

状態
原始和灵活的 React 状态管理

介绍

欢迎使用 Jotai 文档! Jotai 是一个原始而灵活的 React 状态管理库。 它采用自下而上的方法,采用受 Recoil 启发的原子模型。

特性

  • 最小的 API
  • 面向 TypeScript
  • 包尺寸很小 (3kb)
  • 许多额外的 utils 和官方集成
  • 支持 Next.js 和 React Native

安装

npm install jotaiyarn add jotai

基础

了解该库的基本概念和原语,了解它与其他解决方案的比较,并查看它的使用示例。

概念比较案例

向导

这些指南可以帮助处理常见用例,例如异步行为、TypeScript 和 Next.js。

异步TypeScript调试持久化Next.jsReact Native可复位原子中的 Atom测试Vite内部核心组合 atom在 Render 中初始化 Atom State性能迁移到 Jotai v2 API

API

Jotai 有一个非常小的 API,只公开了主要的 jotai 包中的一些导出。 每一个都在核心文档中有更详细的解释。 Jotai 还有一个很好的调试工具和一些有用的 Babel 和 SWC 插件。

核心DevtoolsBabelSWC

Utilities

Jotai 还包含一个 jotai/utils 包,其中包含各种额外的 utils。 一个示例是 atomWithStorage,它包括 localStorage 持久性和浏览器选项卡同步。

abortableAtomatomFamilyatomWithDefaultatomWithHashatomWithObservableatomWithReduceratomWithStorageatomWithResetfreezeAtomCreatorloadablefreezeAtomRESETselectAtomsplitAtomuseAtomCallbackuseHydrateAtomsuseReducerAtomuseResetAtomwaitForAll

集成

Jotai 为许多官方集成提供了单独的捆绑包,包括用于 React Query 的 atomWithQuery 和用于 XState 的 atomWithMachine 等。

ImmerOpticsTanStack QueryXStateValtioZustandReduxURQLLocationtRPC分子Relay缓存

高级用法

这些秘诀可以帮助实现更高级的模式。

大对象创建 Atom自定义 useAtom hooks