React要重写文档了

Vue和React，谁才是更好的选择，这个争论似乎从未停过。但在一点上，双方粉丝似乎达成了难得的一致：

Vue文档比React文档好太多。

React开发者对此的解释是：Vue是国人开发的嘛，写出来的文档当然更符合中国人看啦。

但从#3308[1]来看，似乎全球React开发者都苦文档久矣。以至于在这个issue中，React Core Team成员rachelnabors声泪俱下的说：

“为了弥补官方文档的不足，热心的开发者们自制了很多React教程。我们多么希望从你编写第一个React组件开始，直至你职业生涯的终结，官方文档都是唯一那个陪在你身边的‘他’啊”。

随着Hooks认可度越来越高，可现有文档是围绕ClassComponent展开的，Hooks只是一个独立章节。

基于这些原因，React团队决定重写文档。

React文档难懂的本质原因

文档之间的差异真的仅仅因为“中国人编写的文档更适合中国人看”?显然不是。

要理解文档的差异，需要先谈框架的差异。

Vue基于“模版语言”开发，抽象程度更高。本质上他的文档就是介绍“模版语言”的语法。

那么就把需要的语法背下来就行了。

而React抽象程度更低，直接使用JS(JSX仅仅是语法糖)。

相比于Vue语法靠背就行，React需要花大篇幅讲解各种数据流、设计模式如何在React中使用。

君不见为了解决组件复用，React有HOC、render props、组合模式等众多概念。

这一下就难了。

新文档有哪些改动

知道问题的症结，让我们看看新文档会有哪些改动。

1.以Hooks的使用贯穿整个文档

不再以ClassComponent举例，这也表明Hooks成为事实上的开发标准已经获得社区的认可。

2.为编程小白准备的“术语、概念解释”。

React，包括Redux很喜欢(修改下，是非常喜欢)用各种理论、概念指导工作(比如代数效应之于Hooks)。

这让很多前端一边惊叹“高大上”一边哀嚎“看不懂”。

为此，新的文档会增加很多术语、概念的解释。

3.更多的示例图，在线demo，集成Dev-tools和lint。

图文并茂方便理解，在线demo方便边学边练。双管齐下，用心良苦。

并且，这次新文档由蛋总(Dan Abramov)亲自操刀。前端届顶级网红出马，重视程度可见一斑。

什么时候能看到

这么香，什么时候能看到呢?官方给出的答案是：2021年初。

当前版本文档会归档，新版文档不会在当前版本文档基础上修改。

如果等不及了，社区提供了基于Hooks的当前版本文档[2]解解馋。

参考资料

[1]#3308: https://github.com/reactjs/reactjs.org/issues/3308[2]基于Hooks的当前版本文档: https://reactwithhooks.netlify.app/

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源：创新互联

猜你还喜欢下面的内容