3 月 17 日,出全在 React 新文档的新官 Beta 版上线一年之后,React 终于正式发布了全新的式推 React 官方文档!新文档已启用新的出全域名:https://react.dev/。不过,新官目前新文档只发布了英文版,式推中文版并未上线。出全
目前,新官访问 Beta 版文档(https://beta.reactjs.org/)和英文文档(https://reactjs.org/)时,都会重定向到新域名(https://react.dev/)。
新的文档目前并未提供其他语言的文档入口。
新文档主要包含以下部分:
下面就来看看全新的 React 文档都有哪些特色!
当 2018 年发布 Hooks 时,Hooks 文档假设读者已经熟悉类组件。这有助于社区迅速采用 Hooks,但过了一段时间,旧文档就无法满足新读者的需求。新读者必须要学习两次React:先学习类组件,再学习 Hooks。
而新文档全面拥抱 Hooks,从开始就教授如何使用 Hooks 来学习 React。文档分为两个主要部分:
注意:目前仍有一些类组件用例没有基于 Hook 的实现。类组件仍然得到支持,并在新站点的 Legacy API[3] 部分进行了记录。
Learn 包含两部分:Quick Start 和 Learn React。
React 学习教程的入门部分,介绍了 React 的基本概念和语法,例如组件、属性和状态等。
如果希望通过实践学习,文档还提供了一个井字棋教程。该教程使用 React 构建了一个井字棋小游戏,并教授了一些开发技能。这是一个在线交互式教程,可以自己尝试修改:
除了井字棋教程之外,这一部分还包含了一个 Thinking in React 教程,帮助用户更深刻的理解 React。
上面的井字棋沙箱只是新文档众多示例的其中之一,整个网站添加了超过 600 个沙箱!可以编辑任何沙箱,或在右上角按“Fork”将其在一个单独的选项卡中打开。
Quick Start 部分并没有详细介绍如何使用 React。可以在 Learn React 部分一步步学习 如何使用 React。该部分包含四个模块:
Learn 部分的大多数页面都以一些挑战结尾,以检查理解程度。例如,以下是有关条件渲染页面的挑战:
在每个挑战的左下角都有一个 Show solution 按钮,可以点击查看挑战的解决方案。
在教程中,通过了很多更直观的图表,以帮助快速快速理解。例如,这是 Preserving and Resetting State 中的一张图表:
我们还可以在新文档中看到一些插图,下面是绘制屏幕的浏览器:
在 API Reference 中,每个 React API 现在都有一个专用的页面。这包括各种 API:
每个 API 页面都至少分为两个部分:
除此之外,一些 API 页面还包括故障排除(针对常见问题)和备选方案(针对已弃用的 API)。希望这种方法将使 API Reference 不仅作为一种查找参数的方式,而且作为一种方式来查看可以使用任何给定的 API 执行的所有不同的事情——以及它如何连接到其他 API。
React 拥有一个由数百万开发人员组成的社区,Community 部分包含了一些可以加入的 React 相关社区。除此之外,还包含了React 会议、React 视频、React 聚会、React 团队、React 文档贡献者、致谢以及版本控制策略。
React 团队花了很长时间才发布新文档。希望保持 React 社区应得的高质量标准。在编写这些文档和创建所有示例时,React 团队发现了自己的一些解释中的错误、React 中的错误,甚至现在正在努力解决的 React 设计中的漏洞。希望新文档能帮助 React 团队在未来将 React 提升到一个更高的标准。
社区中还有许多对扩展网站内容和功能的要求,例如:
现在新文档已经发布了,未来 React 团队的重点就是添加新信息和进一步改进新网站。
最后,期待新文档中文版能尽快上线!
[1]Learn React: https://react.dev/learn。
[2]API Reference: https://react.dev/reference。
[3]Legacy API: https://react.dev/reference/react/legacy。
责任编辑:姜华 来源: 前端充电宝 React新官方文档(责任编辑:娱乐)
鲁西化工(000830.SZ)公布消息:拟开展外汇衍生品交易业务
「云原生」稳定性和可扩展性更强的k8s高可用方案讲解与实战操作
美尚生态(300495.SZ):控股股东解除质押及质押2894万股 占其所持股份比例14.39%
推动DevOps卓越:为您的DevOps团队实施服务水平目标(SLOs)
1月浙江新设外商投资企业287家 实际使用外资规模居全国第五