[[430523]]

大家好，我卡頌。

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

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

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

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

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

新文檔的特色

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

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

具體來說，新文檔有三個特點：

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

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

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

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

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

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

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

API 

新手入門

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

1. 安裝
2. 用 React 的方式思考
3. 描述 UI
4. 增加交互
5. 管理狀態(tài)
6. 如何繞過 React 去手動操作 DOM

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

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

API介紹

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

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

總結(jié)

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

新文檔地址：

https:// beta.reactjs.org/