React：用于构建用户界面的 JavaScript 库

React 是一个用于构建用户界面的 JavaScript 库。

声明式：React 让创建交互式 UI 变得轻松。为应用中的每个状态设计简单的视图，React 会在数据变化时高效地更新并渲染恰当的组件。声明式视图让你的代码更可预测、更易理解、更易调试。

基于组件：构建封装好的组件，由组件管理自身状态，再将它们组合成复杂的 UI。由于组件逻辑用 JavaScript 编写而不是模板，你可以轻松在应用中传递丰富的数据，并把状态保持在 DOM 之外。

一次学习，随处编写：我们不对你技术栈的其余部分做任何假设，因此你可以在不重写现有代码的情况下用 React 开发新功能。React 还可以使用 Node 在服务器上渲染，并通过 React Native 驱动移动应用。

了解如何在你的项目中使用 React。

安装#

React 从一开始就设计为可渐进式采用，你可以按需使用或多或少 React：

• 使用快速开始来体验 React。
• 将 React 添加到现有项目，按需使用或多或少 React。
• 如果你在寻找强大的 JavaScript 工具链，请创建新的 React 应用。

文档#

你可以在网站上找到 React 文档。

查看入门页面以快速了解概况。

文档分为几个部分：

• 快速开始
• 教程
• 用 React 的方式思考
• 安装
• 描述 UI
• 添加交互
• 管理状态
• 高级指南
• API 参考

获取支持#

• 贡献指南

你可以通过向此仓库发送 pull request 来改进它。

示例#

我们在网站上有几个示例。以下是帮助你入门的第一个示例：

import { createRoot } from 'react-dom/client';

function HelloMessage({ name }) {
  return <div>Hello {name}</div>;
}

const root = createRoot(document.getElementById('container'));
root.render(<HelloMessage name="Taylor" />);

这个示例会把「Hello Taylor」渲染到页面上的一个容器中。

你会注意到我们使用了类似 HTML 的语法；我们称之为 JSX。JSX 并不是使用 React 的必需条件，但它让代码更易读，写起来感觉就像在写 HTML。

贡献#

本仓库的主要目的是继续演进 React 核心，让它更快、更易用。React 的开发在 GitHub 上公开进行，我们感谢社区贡献 bug 修复和改进。请阅读下文，了解如何参与改进 React。

行为准则#

Facebook 已通过一项行为准则，我们希望项目参与者遵守。请阅读全文，以了解哪些行为会被容忍、哪些不会。

贡献指南#

阅读我们的贡献指南，了解我们的开发流程、如何提出 bug 修复和改进，以及如何构建和测试你对 React 的更改。

适合新手的 issue#

为了帮助你熟悉贡献流程，我们列出了一批适合新手的 issue，其中的 bug 范围相对有限。这是一个很好的起点。

许可证#

React 采用 MIT 许可证。

关于#

用于 Web 和原生用户界面的库。

react.dev

主题：declarative、frontend、javascript、library、react、ui