JotaiJotai

状態
Primitive and flexible state management for React

介绍

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

特性

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

安装

npm install jotaiyarn add jotai

基础

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

概念
比较
案例

向导

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

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

API

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

核心
Utils
Devtools
Babel
SWC

Utilities

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

abortableAtom
atomFamily
atomWithDefault
atomWithHash
atomWithObservable
atomWithReducer
atomWithReset
atomWithStorage
freezeAtomCreator
freezeAtom
loadable
RESET
selectAtom
splitAtom
useAtomCallback
useResetAtom
waitForAll
useReducerAtom
useHydrateAtoms

集成

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

Immer
Optics
TanStack Query
XState
Valtio
Zustand
Redux
URQL
Location
tRPC
分子
Relay
缓存

高级用法

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

大对象
创建 Atom
自定义 useAtom hooks