# React Documentation

> The library for web and native user interfaces.

## 学习 React

### 起步

#### 快速入门
- [快速入门](https://zh-hans.react.dev/learn.md)
- [教程：井字棋游戏](https://zh-hans.react.dev/learn/tutorial-tic-tac-toe.md)
- [React 哲学](https://zh-hans.react.dev/learn/thinking-in-react.md)

#### 安装
- [安装](https://zh-hans.react.dev/learn/installation.md)
- [创建一个 React 应用](https://zh-hans.react.dev/learn/creating-a-react-app.md)
- [从零构建一个 React 应用](https://zh-hans.react.dev/learn/build-a-react-app-from-scratch.md)
- [将 React 添加到现有项目中](https://zh-hans.react.dev/learn/add-react-to-an-existing-project.md)

#### 配置
- [配置](https://zh-hans.react.dev/learn/setup.md)
- [编辑器设置](https://zh-hans.react.dev/learn/editor-setup.md)
- [使用 TypeScript](https://zh-hans.react.dev/learn/typescript.md)
- [React 开发者工具](https://zh-hans.react.dev/learn/react-developer-tools.md)

#### React Compiler
- [React Compiler](https://zh-hans.react.dev/learn/react-compiler.md)
- [介绍](https://zh-hans.react.dev/learn/react-compiler/introduction.md)
- [安装](https://zh-hans.react.dev/learn/react-compiler/installation.md)
- [逐步使用](https://zh-hans.react.dev/learn/react-compiler/incremental-adoption.md)
- [调试和故障排除](https://zh-hans.react.dev/learn/react-compiler/debugging.md)

### 学习 React

#### 描述 UI
- [描述 UI](https://zh-hans.react.dev/learn/describing-the-ui.md)
- [你的第一个组件](https://zh-hans.react.dev/learn/your-first-component.md)
- [组件的导入与导出](https://zh-hans.react.dev/learn/importing-and-exporting-components.md)
- [使用 JSX 书写标签语言](https://zh-hans.react.dev/learn/writing-markup-with-jsx.md)
- [在 JSX 中通过大括号使用 JavaScript](https://zh-hans.react.dev/learn/javascript-in-jsx-with-curly-braces.md)
- [将 Props 传递给组件](https://zh-hans.react.dev/learn/passing-props-to-a-component.md)
- [条件渲染](https://zh-hans.react.dev/learn/conditional-rendering.md)
- [渲染列表](https://zh-hans.react.dev/learn/rendering-lists.md)
- [保持组件纯粹](https://zh-hans.react.dev/learn/keeping-components-pure.md)
- [将 UI 视为树](https://zh-hans.react.dev/learn/understanding-your-ui-as-a-tree.md)

#### 添加交互
- [添加交互](https://zh-hans.react.dev/learn/adding-interactivity.md)
- [响应事件](https://zh-hans.react.dev/learn/responding-to-events.md)
- [state：组件的记忆](https://zh-hans.react.dev/learn/state-a-components-memory.md)
- [渲染和提交](https://zh-hans.react.dev/learn/render-and-commit.md)
- [state 如同一张快照](https://zh-hans.react.dev/learn/state-as-a-snapshot.md)
- [把一系列 state 更新加入队列](https://zh-hans.react.dev/learn/queueing-a-series-of-state-updates.md)
- [更新 state 中的对象](https://zh-hans.react.dev/learn/updating-objects-in-state.md)
- [更新 state 中的数组](https://zh-hans.react.dev/learn/updating-arrays-in-state.md)

#### 状态管理
- [状态管理](https://zh-hans.react.dev/learn/managing-state.md)
- [用 State 响应输入](https://zh-hans.react.dev/learn/reacting-to-input-with-state.md)
- [选择 State 结构](https://zh-hans.react.dev/learn/choosing-the-state-structure.md)
- [在组件间共享状态](https://zh-hans.react.dev/learn/sharing-state-between-components.md)
- [对 state 进行保留和重置](https://zh-hans.react.dev/learn/preserving-and-resetting-state.md)
- [迁移状态逻辑至 Reducer 中](https://zh-hans.react.dev/learn/extracting-state-logic-into-a-reducer.md)
- [使用 Context 深层传递参数](https://zh-hans.react.dev/learn/passing-data-deeply-with-context.md)
- [使用 Reducer 和 Context 拓展你的应用](https://zh-hans.react.dev/learn/scaling-up-with-reducer-and-context.md)

#### 脱围机制
- [脱围机制](https://zh-hans.react.dev/learn/escape-hatches.md)
- [使用 ref 引用值](https://zh-hans.react.dev/learn/referencing-values-with-refs.md)
- [使用 ref 操作 DOM](https://zh-hans.react.dev/learn/manipulating-the-dom-with-refs.md)
- [使用 Effect 进行同步](https://zh-hans.react.dev/learn/synchronizing-with-effects.md)
- [你可能不需要 Effect](https://zh-hans.react.dev/learn/you-might-not-need-an-effect.md)
- [响应式 Effect 的生命周期](https://zh-hans.react.dev/learn/lifecycle-of-reactive-effects.md)
- [将事件从 Effect 中分开](https://zh-hans.react.dev/learn/separating-events-from-effects.md)
- [移除 Effect 依赖](https://zh-hans.react.dev/learn/removing-effect-dependencies.md)
- [使用自定义 Hook 复用逻辑](https://zh-hans.react.dev/learn/reusing-logic-with-custom-hooks.md)

## API 参考

### React
- [总览](https://zh-hans.react.dev/reference/react.md)

#### Hook
- [Hook](https://zh-hans.react.dev/reference/react/hooks.md)
- [useActionState](https://zh-hans.react.dev/reference/react/useActionState.md)
- [useCallback](https://zh-hans.react.dev/reference/react/useCallback.md)
- [useContext](https://zh-hans.react.dev/reference/react/useContext.md)
- [useDebugValue](https://zh-hans.react.dev/reference/react/useDebugValue.md)
- [useDeferredValue](https://zh-hans.react.dev/reference/react/useDeferredValue.md)
- [useEffect](https://zh-hans.react.dev/reference/react/useEffect.md)
- [useEffectEvent](https://zh-hans.react.dev/reference/react/useEffectEvent.md)
- [useId](https://zh-hans.react.dev/reference/react/useId.md)
- [useImperativeHandle](https://zh-hans.react.dev/reference/react/useImperativeHandle.md)
- [useInsertionEffect](https://zh-hans.react.dev/reference/react/useInsertionEffect.md)
- [useLayoutEffect](https://zh-hans.react.dev/reference/react/useLayoutEffect.md)
- [useMemo](https://zh-hans.react.dev/reference/react/useMemo.md)
- [useOptimistic](https://zh-hans.react.dev/reference/react/useOptimistic.md)
- [useReducer](https://zh-hans.react.dev/reference/react/useReducer.md)
- [useRef](https://zh-hans.react.dev/reference/react/useRef.md)
- [useState](https://zh-hans.react.dev/reference/react/useState.md)
- [useSyncExternalStore](https://zh-hans.react.dev/reference/react/useSyncExternalStore.md)
- [useTransition](https://zh-hans.react.dev/reference/react/useTransition.md)

#### 组件
- [组件](https://zh-hans.react.dev/reference/react/components.md)
- [<Fragment> (<>)](https://zh-hans.react.dev/reference/react/Fragment.md)
- [<Profiler>](https://zh-hans.react.dev/reference/react/Profiler.md)
- [<StrictMode>](https://zh-hans.react.dev/reference/react/StrictMode.md)
- [<Suspense>](https://zh-hans.react.dev/reference/react/Suspense.md)
- [<Activity>](https://zh-hans.react.dev/reference/react/Activity.md)
- [<ViewTransition>](https://zh-hans.react.dev/reference/react/ViewTransition.md)

#### API
- [API](https://zh-hans.react.dev/reference/react/apis.md)
- [act](https://zh-hans.react.dev/reference/react/act.md)
- [addTransitionType](https://zh-hans.react.dev/reference/react/addTransitionType.md)
- [cache](https://zh-hans.react.dev/reference/react/cache.md)
- [cacheSignal](https://zh-hans.react.dev/reference/react/cacheSignal.md)
- [captureOwnerStack](https://zh-hans.react.dev/reference/react/captureOwnerStack.md)
- [createContext](https://zh-hans.react.dev/reference/react/createContext.md)
- [lazy](https://zh-hans.react.dev/reference/react/lazy.md)
- [memo](https://zh-hans.react.dev/reference/react/memo.md)
- [startTransition](https://zh-hans.react.dev/reference/react/startTransition.md)
- [use](https://zh-hans.react.dev/reference/react/use.md)
- [experimental_taintObjectReference](https://zh-hans.react.dev/reference/react/experimental_taintObjectReference.md)
- [experimental_taintUniqueValue](https://zh-hans.react.dev/reference/react/experimental_taintUniqueValue.md)

### React Dom

#### Hook
- [Hook](https://zh-hans.react.dev/reference/react-dom/hooks.md)
- [useFormStatus](https://zh-hans.react.dev/reference/react-dom/hooks/useFormStatus.md)

#### 组件
- [组件](https://zh-hans.react.dev/reference/react-dom/components.md)
- [Common (e.g. <div>)](https://zh-hans.react.dev/reference/react-dom/components/common.md)
- [<form>](https://zh-hans.react.dev/reference/react-dom/components/form.md)
- [<input>](https://zh-hans.react.dev/reference/react-dom/components/input.md)
- [<option>](https://zh-hans.react.dev/reference/react-dom/components/option.md)
- [<progress>](https://zh-hans.react.dev/reference/react-dom/components/progress.md)
- [<select>](https://zh-hans.react.dev/reference/react-dom/components/select.md)
- [<textarea>](https://zh-hans.react.dev/reference/react-dom/components/textarea.md)
- [<link>](https://zh-hans.react.dev/reference/react-dom/components/link.md)
- [<meta>](https://zh-hans.react.dev/reference/react-dom/components/meta.md)
- [<script>](https://zh-hans.react.dev/reference/react-dom/components/script.md)
- [<style>](https://zh-hans.react.dev/reference/react-dom/components/style.md)
- [<title>](https://zh-hans.react.dev/reference/react-dom/components/title.md)

#### API
- [API](https://zh-hans.react.dev/reference/react-dom.md)
- [createPortal](https://zh-hans.react.dev/reference/react-dom/createPortal.md)
- [flushSync](https://zh-hans.react.dev/reference/react-dom/flushSync.md)
- [preconnect](https://zh-hans.react.dev/reference/react-dom/preconnect.md)
- [prefetchDNS](https://zh-hans.react.dev/reference/react-dom/prefetchDNS.md)
- [preinit](https://zh-hans.react.dev/reference/react-dom/preinit.md)
- [preinitModule](https://zh-hans.react.dev/reference/react-dom/preinitModule.md)
- [preload](https://zh-hans.react.dev/reference/react-dom/preload.md)
- [preloadModule](https://zh-hans.react.dev/reference/react-dom/preloadModule.md)

#### 客户端 API
- [客户端 API](https://zh-hans.react.dev/reference/react-dom/client.md)
- [createRoot](https://zh-hans.react.dev/reference/react-dom/client/createRoot.md)
- [hydrateRoot](https://zh-hans.react.dev/reference/react-dom/client/hydrateRoot.md)

#### 服务端 API
- [服务端 API](https://zh-hans.react.dev/reference/react-dom/server.md)
- [renderToPipeableStream](https://zh-hans.react.dev/reference/react-dom/server/renderToPipeableStream.md)
- [renderToReadableStream](https://zh-hans.react.dev/reference/react-dom/server/renderToReadableStream.md)
- [renderToStaticMarkup](https://zh-hans.react.dev/reference/react-dom/server/renderToStaticMarkup.md)
- [renderToString](https://zh-hans.react.dev/reference/react-dom/server/renderToString.md)
- [resume](https://zh-hans.react.dev/reference/react-dom/server/resume.md)
- [resumeToPipeableStream](https://zh-hans.react.dev/reference/react-dom/server/resumeToPipeableStream.md)

#### Static APIs
- [Static APIs](https://zh-hans.react.dev/reference/react-dom/static.md)
- [prerender](https://zh-hans.react.dev/reference/react-dom/static/prerender.md)
- [prerenderToNodeStream](https://zh-hans.react.dev/reference/react-dom/static/prerenderToNodeStream.md)
- [resumeAndPrerender](https://zh-hans.react.dev/reference/react-dom/static/resumeAndPrerender.md)
- [resumeAndPrerenderToNodeStream](https://zh-hans.react.dev/reference/react-dom/static/resumeAndPrerenderToNodeStream.md)

### React Compiler
- [Compiling Libraries](https://zh-hans.react.dev/reference/react-compiler/compiling-libraries.md)

#### 配置
- [配置](https://zh-hans.react.dev/reference/react-compiler/configuration.md)
- [compilationMode](https://zh-hans.react.dev/reference/react-compiler/compilationMode.md)
- [gating](https://zh-hans.react.dev/reference/react-compiler/gating.md)
- [logger](https://zh-hans.react.dev/reference/react-compiler/logger.md)
- [panicThreshold](https://zh-hans.react.dev/reference/react-compiler/panicThreshold.md)
- [target](https://zh-hans.react.dev/reference/react-compiler/target.md)

#### 指令
- [指令](https://zh-hans.react.dev/reference/react-compiler/directives.md)
- ["use memo"](https://zh-hans.react.dev/reference/react-compiler/directives/use-memo.md)
- ["use no memo"](https://zh-hans.react.dev/reference/react-compiler/directives/use-no-memo.md)

### React DevTools
- [React Performance tracks](https://zh-hans.react.dev/reference/dev-tools/react-performance-tracks.md)

### Eslint Plugin React Hooks

#### Lints
- [Lints](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks.md)
- [exhaustive-deps](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/exhaustive-deps.md)
- [rules-of-hooks](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/rules-of-hooks.md)
- [component-hook-factories](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/component-hook-factories.md)
- [config](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/config.md)
- [error-boundaries](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/error-boundaries.md)
- [gating](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/gating.md)
- [globals](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/globals.md)
- [immutability](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/immutability.md)
- [incompatible-library](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/incompatible-library.md)
- [preserve-manual-memoization](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/preserve-manual-memoization.md)
- [purity](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/purity.md)
- [refs](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/refs.md)
- [set-state-in-effect](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/set-state-in-effect.md)
- [set-state-in-render](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/set-state-in-render.md)
- [static-components](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/static-components.md)
- [unsupported-syntax](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/unsupported-syntax.md)
- [use-memo](https://zh-hans.react.dev/reference/eslint-plugin-react-hooks/lints/use-memo.md)

### React 规则

#### 概述
- [概述](https://zh-hans.react.dev/reference/rules.md)
- [组件和 Hook 必须是纯粹的](https://zh-hans.react.dev/reference/rules/components-and-hooks-must-be-pure.md)
- [React 调用组件和 Hook](https://zh-hans.react.dev/reference/rules/react-calls-components-and-hooks.md)
- [Hook 的规则](https://zh-hans.react.dev/reference/rules/rules-of-hooks.md)

### React 服务器组件
- [服务器组件](https://zh-hans.react.dev/reference/rsc/server-components.md)
- [Server Functions](https://zh-hans.react.dev/reference/rsc/server-functions.md)

#### 指令符
- [指令符](https://zh-hans.react.dev/reference/rsc/directives.md)
- ['use client'](https://zh-hans.react.dev/reference/rsc/use-client.md)
- ['use server'](https://zh-hans.react.dev/reference/rsc/use-server.md)

### 过时的 API

#### 过时的 React API
- [过时的 React API](https://zh-hans.react.dev/reference/react/legacy.md)
- [Children](https://zh-hans.react.dev/reference/react/Children.md)
- [cloneElement](https://zh-hans.react.dev/reference/react/cloneElement.md)
- [Component](https://zh-hans.react.dev/reference/react/Component.md)
- [createElement](https://zh-hans.react.dev/reference/react/createElement.md)
- [createRef](https://zh-hans.react.dev/reference/react/createRef.md)
- [forwardRef](https://zh-hans.react.dev/reference/react/forwardRef.md)
- [isValidElement](https://zh-hans.react.dev/reference/react/isValidElement.md)
- [PureComponent](https://zh-hans.react.dev/reference/react/PureComponent.md)