React全新文檔終于來了

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

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

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

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

新文檔的特色

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

如果說老文檔是論文，那新文檔就是教科書

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

1. 所有示例都會用Hooks完成

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

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

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

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

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

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

• 新手入門

• API介紹

新手入門

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

1. 安裝

2. 用React的方式思考

3. 描述UI

4. 增加交互

5. 管理狀態(tài)

6. 如何繞過React去手動操作DOM

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

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

API介紹

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

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

總結(jié)

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

新文檔地址：

https://beta.reactjs.org/

對新文檔你有什么想說的，歡迎討論。

參考資料