React全新文档终于来了 React全新文档终于来了

【React全新文档终于来了】大家好，我卡颂。
React一直被吐槽官方文档对新手不友好，而且自从v16.8出现Hooks后，Hooks逐渐成为React主要发展方向，新特性都会基于Hooks开发。
但是当前官方文档还是基于class component讲解。所以从去年10月开始，React团队的Rachel Nabors开始推进新文档的编写。

文章图片

关于Rachel Nabors的经历，可以参考我之前写的一篇文章从失学二次元少女到React核心成员
时隔一年，21年10月22日，React新文档Beta版终于上线了。

文章图片

本文会介绍新文档相比老文档的不同之处，以及当前进度。
新文档的特色一句话概括新老文档的区别：

如果说老文档是论文，那新文档就是教科书

具体来说，新文档有三个特点：

所有示例都会用Hooks完成

Hooks是React的未来，相比老文档使用Class Component做示例，新文档全面拥抱Hooks。

加入大量交互示例和图表

光是从React视角思考这一节就包括6段代码示例、2张图、3个可交互的示例。

提供习题用来检验学习成果

比如，学习JSX这一节最后有一道习题，需要你修复错误的JSX语法：

文章图片

新文档主要包括两部分内容：

新手入门
API介绍

文章图片

新手入门我们可以从新手入门的章节设计体会React的用意：

安装
用React的方式思考
描述UI
增加交互
管理状态
如何绕过React去手动操作DOM

简言之就是，通过大量示例、试题循序渐进让新手学习React的基本概念。
新手入门部分当前整体进度为：完成70%
API介绍 API介绍围绕Hooks展开，同样包含大量示例。当前整体进度为：完成5%
和class component相关的老API应该不会出现在新文档中，这部分API介绍会被重定向到老文档中。
总结不管是React18讨论组，还是新文档开发，都提供了反馈渠道。任何人都可以通过Github issue #3308和匿名论坛提出意见。
新文档地址：