React

用于构建用户的声明式、高效且灵活的JavaScript库

README

React · GitHub license npm version CircleCI Status PRs Welcome


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

声明式: React 使创建交互式 UI 变得轻松。为应用程序中的每个状态设计简单的视图,React 将在数据更改时有效地更新和呈现正确的组件。声明式视图使您的代码更可预测、更易于理解且更易于调试。
基于组件: 构建管理自身状态的封装组件,然后将它们组合成复杂的 UI。由于组件逻辑是用 JavaScript 而不是模板编写的,因此您可以轻松地通过应用程序传递丰富的数据并将状态保持在 DOM 之外。
一次学习,随处编写: 我们不会对您的其余技术堆栈做出假设,因此您可以在 React 中开发新功能而无需重写现有代码。React 还可以使用 Node 在服务器上呈现,并使用React Native为移动应用程序提供支持。 React Native.


安装


React 从一开始就被设计为逐步采用,您可以根据需要使用尽可能少或尽可能多的 React:

使用Online Playgrounds体验 React。

在一分钟内将 React作为脚本标签添加到网站。

如果您正在寻找功能强大的 JavaScript 工具链,请[创建一个新的 React 应用程序。](

您可以将 React 用作来自CDN的脚本标签,或用作npm上的反应包。

文档


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

查看入门页面以获得快速概览。

该文档分为几个部分:







您可以通过向此存储库发送拉取请求来改进它。

例子


我们在网站上有几个例子。这是让您入门的第一个:

  1. ``` js
  2. import { createRoot } from 'react-dom/client';

  3. function HelloMessage({ name }) {
  4.   return <div>Hello {name}</div>;
  5. }

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

此示例会将“Hello Taylor”呈现到页面上的容器中。

您会注意到我们使用了类似 HTML 的语法;我们称之为 JSX。JSX 不是使用 React 所必需的,但它使代码更具可读性,写起来就像写 HTML 一样。如果您使用 React 作为脚本标签,请阅读本节关于集成 JSX 的内容;否则,推荐的 JavaScript 工具链会自动处理它。

贡献


该存储库的主要目的是继续发展 React 核心,使其更快、更易于使用。React 的开发在 GitHub 上公开进行,我们感谢社区贡献的错误修复和改进。阅读下文,了解如何参与改进 React。


Facebook 采用了我们希望项目参与者遵守的行为准则。请阅读全文,以便您了解哪些行为是可以容忍的,哪些行为是不能容忍的。


阅读我们的贡献指南,了解我们的开发过程,如何提出错误修复和改进,以及如何构建和测试对 React 的更改。

优先问题列表


为了帮助您亲身体验并熟悉我们的贡献流程,我们有一个良好的优先问题列表,其中包含范围相对有限的错误。这是一个很好的起点。

执照