入门
此页面是 React 文档和相关资源的概述。
React 是一个用于构建用户界面的 JavaScript 库。 在我们的主页或教程中了解 React 的全部内容。
尝试 React
React 从一开始就被设计为逐步采用的方式, 并且 您可以根据需要随心所欲的使用 React。 无论你是想为简单的 HTML 页面添加一些交互性,而想尝试 React, 或者启动一个复杂的 React 驱动的应用程序, 本节中的链接将帮助您开始。
在线演练场
如果你对 React 有兴趣,并且想玩一下 React , 你可以使用在线代码演练场。 试试 CodePen 或 CodeSandbox 上的 Hello World 模板。
如果你更喜欢使用自己的文本编辑器, 你也可以 下载这个HTML文件 ,编辑它, 并从浏览器中的本地文件系统中打开它。 它的运行时代码转换很慢, 所以我们只建议使用这个简单的演示。
将 React 添加到网站
您可以 在一分钟内将 React 添加到HTML页面 。 然后,您可以逐渐扩展其存在,或将其包含到一些动态小部件(widgets)中。
创建一个新的 React 应用程序
在开始 React 项目时,简单的带有 script 标签的 HTML 页面 可能仍然是最佳选择。 设置它只需要一分钟!
随着应用程序的增长,您可能需要考虑一个更集成的设置。 我们建议大型应用程序使用 多个 JavaScript 工具链 。 它们中的每一个都可以在几乎没有配置的情况下工作,并让您充分利用丰富的 React 生态系统。
学习 React
学习 React 的人来自不同技术背景和不同学习习惯。 无论你喜欢更偏向理论性的学习,还是注重实际应用的学习, 我们都希望您会发现这些部分对你来说非常有帮助。
和任何不熟悉的技术一样, React 确实有一条学习曲线。 通过多加练习和一些耐心, 你 会 得到 React 的窍门。
JavaScript 环境
我们的 React 文档假定您已经熟悉用 JavaScript 语言的编程。 你不必是专家, 但同时学习 React 和 JavaScript 很难。
我们建议您浏览这些 JavaScript 概述 以检查您的知识水平。 它会花费你30分钟到1小时,但你会对学习 React 更有信心。
Tip
每当你对 JavaScript 中的某些东西感到困惑时,查阅 MDN 和 javascript.info 会对你非常有帮助。还有我们的 社区支持论坛 ),您可以在这里寻求帮助。
实用教程
如果你喜欢 边做边学, 看看我们的 实用教程。 在本教程中,我们用 React 中构建了一个井字游戏。 你可能会试图跳过它,因为你不是为了制作游戏 — 但给它一个机会。 您将在本教程中学到的技巧对于构建 任何 React 应用程序都非常重要, 掌握它会给你更深的理解。
一步一步进阶
如果你喜欢 一步一步学习概念, 我们的 主要概念指南 是最好的开始。 每一章的知识内容都建立在前几章介绍基础上,所以你不会错过任何事情。
React 的编程思想
相信许多 React 用户阅读完 React 的编程思想 后的第一反应就是:终于找到了答案。 这可能是对最古老的 React 走查(集中讨论代码的过程),但它仍然非常有必要阅读。
推荐课程
有时候人们发现第三方书籍和视频课程比官方文档更有帮助。 我们维护了一份 普通推荐的资源列表,其中一些是免费的。
高级概念
一旦你对 主要概念 部分感到满意并且已经使用 React 稍微玩一下, 您可能对更高级的主题感兴趣。 本节将向您介绍强大的, 但不太常用的 React 功能,如 上下文 context 和 refs。
API参考
如果您想了解有关特定 React API 的更多详细信息,此文档部分非常有用。
例如,React.Component
API参考 可以为您提供有关 setState()
工作方式的详细信息,
以及不同的有用的生命周期钩子的详细信息。
术语表和常见问题
术语表 包含了您在 React 文档中看到的最常见术语的概述。 还有一个常见问题部分,专门提供关于常见主题的简短问题和解答, 包括AJAX请求,组件状态(state))和 文件结构 。
保持知情
React博客 是 React 团队更新信息的官方来源。 任何重要的,包括发行说明或弃用声明,都将首先在那里发布。
您还可以在 Twitter上关注 @reactjs 帐户,但是如果你只是阅读博客,你不会错过任何必要的东西。
并非每个 React 版本都会发布对于的博客文章,
但是您可以在 React 仓库中的 CHANGELOG.md
文件 ,以及发布 页面上找到每个版本的详细更新日志。
各个版本文档
本文档始终反映了 React 的最新稳定版本。 自 React 16 以来,您可以在单独页面上找到旧版本的文档。 请注意,过去版本的文档在发布时会被快照,并且不会不断更新。
愚人码头注:React v16.2.0 中文文档
缺少文档?
愚人码头注:中文文档相对翻译进度落后于官方文档,如果没有及时同步翻译,请在微博上 @愚人码头
如果文档中缺少某些内容,或者您发现某些部分有混淆,请 针对文档存储库提出问题 并提出您的改进建议,或通过 @reactjs 帐户 发送推文。我们喜欢听到你的声音!