React全新文檔終于來(lái)了

大家好，我卡頌。

React一直被吐槽官方文檔對(duì)新手不友好，而且自從v16.8出現(xiàn)Hooks后，Hooks逐漸成為React主要發(fā)展方向，新特性都會(huì)基于Hooks開(kāi)發(fā)。

但是當(dāng)前官方文檔還是基于class component講解。所以從去年10月開(kāi)始，React團(tuán)隊(duì)的「Rachel Nabors」開(kāi)始推進(jìn)新文檔的編寫(xiě)。

關(guān)于「Rachel Nabors」的經(jīng)歷，可以參考我之前寫(xiě)的一篇文章從失學(xué)二次元少女到React核心成員

時(shí)隔一年，21年10月22日，React新文檔Beta版^[1]終于上線了。

本文會(huì)介紹新文檔相比老文檔的不同之處，以及當(dāng)前進(jìn)度。

新文檔的特色

一句話概括新老文檔的區(qū)別：

如果說(shuō)老文檔是論文，那新文檔就是教科書(shū)

具體來(lái)說(shuō)，新文檔有三個(gè)特點(diǎn)：

1. 所有示例都會(huì)用Hooks完成

Hooks是React的未來(lái)，相比老文檔使用Class Component做示例，新文檔全面擁抱Hooks。

2. 加入大量交互示例和圖表

光是從React視角思考^[2]這一節(jié)就包括6段代碼示例、2張圖、3個(gè)可交互的示例。

3. 提供習(xí)題用來(lái)檢驗(yàn)學(xué)習(xí)成果

比如，學(xué)習(xí)JSX^[3]這一節(jié)最后有一道習(xí)題，需要你修復(fù)錯(cuò)誤的JSX語(yǔ)法：

新文檔主要包括兩部分內(nèi)容：

• 新手入門

• API介紹

新手入門

我們可以從「新手入門」的章節(jié)設(shè)計(jì)體會(huì)React的用意：

1. 安裝

2. 用React的方式思考

3. 描述UI

4. 增加交互

5. 管理狀態(tài)

6. 如何繞過(guò)React去手動(dòng)操作DOM

簡(jiǎn)言之就是，通過(guò)大量示例、試題循序漸進(jìn)讓新手學(xué)習(xí)React的基本概念。

「新手入門」部分當(dāng)前整體進(jìn)度為：完成70%

API介紹

「API介紹」圍繞Hooks展開(kāi)，同樣包含大量示例。當(dāng)前整體進(jìn)度為：完成5%

和class component相關(guān)的老API應(yīng)該不會(huì)出現(xiàn)在新文檔中，這部分API介紹會(huì)被重定向到老文檔中。

總結(jié)

不管是React18討論組，還是新文檔開(kāi)發(fā)，都提供了反饋渠道。任何人都可以通過(guò)Github issue #3308^[4]和匿名論壇^[5]提出意見(jiàn)。

新文檔地址：

https://beta.reactjs.org/

對(duì)新文檔你有什么想說(shuō)的，歡迎討論。

參考資料