React全新文档终于来了

Python涨薪研究所

共 1353字,需浏览 3分钟

 ·

2021-11-07 01:36


源 /         文/ 

React一直被吐槽官方文档对新手不友好,而且自从v16.8出现Hooks后,Hooks逐渐成为React主要发展方向,新特性都会基于Hooks开发。
但是当前官方文档还是基于class component讲解。所以从去年10月开始,React团队的「Rachel Nabors」开始推进新文档的编写。
关于「Rachel Nabors」的经历,可以参考我之前写的一篇文章从失学二次元少女到React核心成员
时隔一年,21年10月22日,React新文档Beta版[1]终于上线了。
本文会介绍新文档相比老文档的不同之处,以及当前进度。

新文档的特色

一句话概括新老文档的区别:
如果说老文档是论文,那新文档就是教科书
具体来说,新文档有三个特点:
  1. 所有示例都会用Hooks完成
HooksReact的未来,相比老文档使用Class Component做示例,新文档全面拥抱Hooks
  1. 加入大量交互示例和图表
光是从React视角思考[2]这一节就包括6段代码示例、2张图、3个可交互的示例。
  1. 提供习题用来检验学习成果
比如,学习JSX[3]这一节最后有一道习题,需要你修复错误的JSX语法:
新文档主要包括两部分内容:
  • 新手入门
  • API介绍

新手入门

我们可以从「新手入门」的章节设计体会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





END


顶级程序员:topcoding

做最好的程序员社区:Java后端开发、Python、大数据、AI


一键三连「分享」、「点赞」和「在看」


浏览 22
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报