React全新文档终于来了

逃离我推掉我的手 2022-09-17 00:56 175阅读 0赞

`React`一直被吐槽官方文档对新手不友好，而且自从`v16.8`出现`Hooks`后，`Hooks`逐渐成为`React`主要发展方向，新特性都会基于`Hooks`开发。

但是当前官方文档还是基于`class component`讲解。所以从去年10月开始，`React`团队的**「Rachel Nabors」**开始推进新文档的编写。

![1b678aa3c808eec8b0707d0c0a32c927.png][]

> 时隔一年，21年10月22日，React新文档Beta版\[1\]终于上线了。  
>

![72dc52561300e5121f9de9ce72447dbd.png][]

本文会介绍新文档相比老文档的不同之处，以及当前进度。

## 新文档的特色 ##

一句话概括新老文档的区别：

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

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

1.  所有示例都会用`Hooks`完成

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

1.  加入大量交互示例和图表

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

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

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

![7b107880e174a7597cd526fd6b46a955.png][]

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

*  新手入门
 *  `API`介绍

![20964f565274d59a4744623427c2b28d.png][]

## 新手入门 ##

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

1.  安装
2.  用`React`的方式思考
3.  描述`UI`
4.  增加交互
5.  管理状态
6.  如何绕过`React`去手动操作`DOM`

简言之就是，通过大量示例、试题循序渐进让新手学习`React`的基本概念。

**「新手入门」**部分当前整体进度为：完成70%

## API介绍 ##

**「API介绍」**围绕`Hooks`展开，同样包含大量示例。当前整体进度为：完成5%

和`class component`相关的老`API`应该不会出现在新文档中，这部分`API`介绍会被重定向到老文档中。

## 总结 ##

不管是`React18`讨论组，还是新文档开发，都提供了反馈渠道。任何人都可以通过Github issue \#3308\[4\]和匿名论坛\[5\]提出意见。

新文档地址：

> https://beta.reactjs.org/

对新文档你有什么想说的，欢迎讨论。

### 参考资料 ###

\[1\]

React新文档Beta版: https://beta.reactjs.org/

\[2\]

从React视角思考: https://beta.reactjs.org/learn/thinking-in-react

\[3\]

学习JSX: https://beta.reactjs.org/learn/writing-markup-with-jsx

\[4\]

Github issue \#3308: https://github.com/reactjs/reactjs.org/issues/3308

\[5\]

匿名论坛: https://www.surveymonkey.co.uk/r/Y6GH986

[1b678aa3c808eec8b0707d0c0a32c927.png]: /images/20220828/d65e3b5ccd67443fac0a9469eb45cf61.png
[72dc52561300e5121f9de9ce72447dbd.png]: /images/20220828/ddfdd4e8d23e4f818dbab61ef1c44b33.png
[7b107880e174a7597cd526fd6b46a955.png]: /images/20220828/aaa01f9b62774104bd332e94fb1a95d2.png
[20964f565274d59a4744623427c2b28d.png]: /images/20220828/99a1c944a39c4a30aedde6c35fa59353.png

发表评论取消回复

表情：

评论列表（有 0 条评论，175人围观）

还没有评论，来说两句吧...

相关阅读

相关扶我起来，Vue 3.0终于来了！

十一各大旅游景点热闹非凡，我们的IT界也同样迎来了爆炸热点。没错，雨溪大神来了，他带着Vue 3.0 源码来了。（ps: 源码地址: https://github.com/vu

一时失言乱红尘/ 2023年06月06日 07:53/ 0 赞/ 145 阅读

相关 Python 3.10来了，switch语法终于出现

> 机器之心报道 > > 编辑：陈萍 > 不用再自己琢磨如何实现 switch 功能了。对于从事数据科学和人工智能领域的人们来说，Python 是大家的首选编程语言。根

喜欢ヅ旅行/ 2023年01月14日 11:55/ 0 赞/ 87 阅读

相关 Python 3.10来了，switch语法终于出现

‍ ‍ 转自：机器之心终于不用再自己琢磨如何实现 switch 功能了。对于从事数据科学和人工智能领域的人们来说，Python 是大家的首选编程语言。根据最近的一项

港控/mmm°/ 2023年01月14日 02:56/ 0 赞/ 123 阅读

相关千呼万唤始出来：JUC灵魂AQS终于来了

1、JUC的由来 [synchronized][] 关键字是JDK官方人员用C++代码写的，在JDK6以前是重量级锁。Java大牛 Doug Lea对 [synchron

╰半橙微兮°/ 2022年12月28日 15:30/ 0 赞/ 142 阅读

相关它来了，它终于来了！

推荐序四个月时间，可以干嘛！看完一本书？追完一部剧？从0到1上线一个互联网项目？而儒猿技术团队则用四个月时间，精心打磨出了这款：基于RocketMQ的互联网

秒速五厘米/ 2022年10月22日 10:59/ 0 赞/ 283 阅读

相关 Sublime Text 4！终于来了！

公众号关注 “GitHubDaily” 设为 “星标”，每天带你逛 GitHub！ ![7b1d1391e6d0833ecea5ea75c7d342dd.png][] 大

缺乏、安全感/ 2022年10月05日 15:51/ 0 赞/ 210 阅读

相关 React全新文档终于来了

`React`一直被吐槽官方文档对新手不友好，而且自从`v16.8`出现`Hooks`后，`Hooks`逐渐成为`React`主要发展方向，新特性都会基于`Hooks`开发。

逃离我推掉我的手/ 2022年09月17日 00:56/ 0 赞/ 176 阅读

相关喜大普奔！Django官方文档终于出中文版了

昨天经 Sur 同学告知才发现，Django 官方文档居然支持中文了！ ![v2-277aa23e1c242d5f6ebc8960c90e2ac9_b.jpg][]![Ima

た入场券/ 2022年05月11日 12:44/ 0 赞/ 149 阅读

相关 Windows 10 全新界面要来了：焕然一新

点击上方 [Java后端][Java]，选择设为星标优质文章，及时送达 -------------------- 来自扩展迷据外媒最新报道称，备受期待的 W

红太狼/ 2021年09月03日 08:42/ 0 赞/ 287 阅读

相关 IntelliJ 发布 2020 RoadMap，中文版终于要来了？

![format_png][] 作者 | oschina 链接 | www.oschina.net/news/112937/intellij-based-ide-f

ゝ一纸荒年。/ 2021年08月24日 16:12/ 0 赞/ 417 阅读