查看原文
其他

React 要重写文档了

前端大全 2021-01-15

The following article is from 魔术师卡颂 Author 卡颂

(给前端大全加星标,提升前端技能

作者:魔术师卡颂 公号 / 卡颂

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

Vue文档比React文档好太多。

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

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

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

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

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

React文档难懂的本质原因

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

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

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

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

React抽象程度更低,直接使用JSJSX仅仅是语法糖)。

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

君不见为了解决组件复用,ReactHOCrender props组合模式等众多概念。

这一下就难了。

新文档有哪些改动

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

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

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

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

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

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

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

  1. 更多的示例图,在线demo,集成Dev-toolslint

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

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

什么时候能看到

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

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

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

参考资料

[1]

#3308: https://github.com/reactjs/reactjs.org/issues/3308

[2]

基于Hooks的当前版本文档: https://reactwithhooks.netlify.app/



推荐阅读  点击标题可跳转

1、Facebook 新一代 React 状态管理库 Recoil

2、代数效应与 React

3、唐朝人更懂 React


觉得本文对你有帮助?请分享给更多人

关注「前端大全」加星标,提升前端技能

点赞和在看就是最大的支持❤️

    您可能也对以下帖子感兴趣

    文章有问题?点此查看未经处理的缓存