全新的 React 文本文档都有什么特点!

lxf2023-04-04 20:46:02

3 月 17 日,在 React 新文档的 Beta 版发布一年之后,React 总算正式发布了一个全新的 React 官方文档!新文档已启动一个新的网站域名:react.dev/。 但是,现阶段新文档只发布英语版,汉化版并没有发布。

全新的 React 文本文档都有什么特点!

现阶段,浏览 Beta 版文本文档(beta.reactjs.org/)和英文文档(reactjs.org/)时,都是会跳转到最新域名(react.dev/)。 全新的 React 文本文档都有什么特点! 一个新的文本文档现阶段并没有给予外国语言的文本文档通道。

  • 如果需要浏览老旧汉化版文本文档,能够浏览:zh-hans.reactjs.org/。
  • 如果需要浏览旧的英文版文本文档,能够浏览:legacy.reactjs.org/。

新文档主要包括下列一部分:

  • 实例教程和手册:提供了大量的实例教程和手册,协助开发人员从零开始学习培训React或深入分析特殊主题风格。
  • 编码实例和演试:给予了一系列的编码实例和演试,展现了React的强大和协调能力。
  • 良好实践与技巧:掌握最新React良好实践与技巧,学习怎么优化代码并实现更强性能
  • 社区网站:与其它 React 开发者联络,在工程中获取协助或者在小区共享专业技能。
  • 新闻报道和更新:第一时间掌握 React 软件开发团队的最新版、升级和资讯新闻。

下面一起来看看一个全新的 React 文本文档都有什么特点!

全方位相拥 Hooks

当 2018 年发布 Hooks 时,Hooks 文本文档假定阅读者早已了解类部件。这有利于小区快速选用 Hooks,但过了一段时间,旧文件就不能满足新阅读者要求。新阅读者务必需要学习2次React:先知识类部件,深入学习 Hooks。

而新文档全方位相拥 Hooks,从最开始就专家教授怎么使用 Hooks 去学习 React。文本文档分两关键一部分:

  • Learn React:一个自学课程,从零开始专家教授React。
  • API Reference:带来了每一个 React API 的详细资料与使用实例。

留意:现阶段依然存在一些类部件测试用例并没有根据 Hook 的完成。类部件依然获得适用,并且在新站点的 Legacy API 一部分展开了纪录。

Learn

Learn 包括两个部分:Quick Start 和 Learn React。

Quick Start

React 学习教程的新手入门一部分,阐述了 React 的基本概念和词法,比如部件、特性和情况等。

假如希望用实践体验,文本文档还提供了一个井字棋实例教程。该实例教程应用 React 构建了一个井字棋游戏,并专家教授了一些开发设计专业技能。这是一个线上互动式实例教程,能自己试着改动: 全新的 React 文本文档都有什么特点! 除开井字棋实例教程以外,这一部分还包括了一个 [Thinking in React](Thinking in React) 实例教程,帮助大家更清晰的认知 React。

上边的井字棋沙盒仅仅新文档诸多实例的其中之一,全部网址加了超出 600 个沙盒!能够编写一切沙盒,或者在右上方按“Fork”把它在一个独立的菜单栏中开启。

Learn React

Quick Start 一部分并没详解怎么使用 React。还可以在 Learn React 一部分一步步学习培训 怎么使用 React。这一部分包括四个控制模块:

  • Describing the UI:怎样用部件显示
  • Adding Interactivity:怎样回应客户键入升级显示屏
  • Managing State:怎样在运用变得更加繁杂时机构逻辑性
  • Escape Hatches:怎样“摆脱”React,及其何时这么做最惊喜

Learn 一部分的大部分网页页面都是以一些考验末尾,以查验了解水平。 比如,以下属于相关标准渲染页面的考验:

全新的 React 文本文档都有什么特点!

在每一个挑战的左下方都有一个 Show solution 按键,能够查看更多考验解决方案

在教学中,已通过许多更真实的数据图表,可以帮助快速快速了解。 比如,这也是 Preserving and Resetting State 里的一张数据图表:

全新的 React 文本文档都有什么特点!

我们也可以在新文档中看到一些插画图片,以下是制作显示屏浏览器

全新的 React 文本文档都有什么特点!

API Reference

在 API Reference 中,每一个 React API 如今都有一个专用型页面。这包括所有 API:

  • 内嵌 Hooks,如 useState
  • 内嵌部件,如 <Suspense>
  • 内置浏览器部件,如 <input>
  • 面对框架的 API,比如 renderToPipeableStream
  • 别的 React API,比如 memo

每一个 API 网页页面都最少分两一部分:

  • Reference:根据列举其参数和传参来表示 API 的签字。
  • Usage:显示出了为何如何更好地结合实际应用此 API。它显示出了 React 精英团队怎么使用每一个 API 的典型场景。

全新的 React 文本文档都有什么特点!

此外,一些 API 网页页面还包含故障处理(对于疑难问题)和备用方案(对于已弃使用的 API)。期待此方法将导致 API Reference 不但作为一种搜索参数方法,不过作为一种方式查看能够使用任何给定的 API 实施的全部不同类型的事儿——以及它怎样连接到另一个 API。

Community

React 有着一个由上百万开发者构成的群体,Community 一部分包括了一些可以加的 React 有关小区。此外,还包括了React 大会、React 短视频、React 聚会活动、React 精英团队、React 文本文档推动者、感谢及其版本号控制方法。

全新的 React 文本文档都有什么特点!

将来

React 精英团队花掉了很长一段时间才公布新文档。 期待维持 React 小区劳动所得的高品质规范。在编辑这种文本文档和建立全部实例时,React 精英团队看到了自己的一些表述里的不正确、React 里的不正确,乃至如今一直在努力克服的 React 设计中的系统漏洞。期待新文档能够帮助 React 精英团队不久的将来将 React 提高到一个更高规范。

社区中还有很多对拓展网站信息和结构的需求,比如:

  • 为所有实例给予 TypeScript 版本号;
  • 建立升级更新的特性、评估和可访问性手册;
  • 不同于适用他们的框架纪录 React 网络服务器部件;
  • 与国际社区协作汉语翻译新文档;
  • 向新的网站加上欠缺的作用(比如,此blog的 RSS)。

如今新文档早已发布,将来 React 团队关键就是加上最新资讯和进一步改善新的网站。

最终,希望新文档汉化版能尽快发布!