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
新手入門(mén)
我們可以從 「新手入門(mén)」 的章節(jié)設(shè)計(jì)體會(huì) React 的用意：
- 安裝
- 用
React的方式思考 - 描述
UI - 增加交互
- 管理狀態(tài)
- 如何繞過(guò)
React去手動(dòng)操作DOM
簡(jiǎn)言之就是，通過(guò)大量示例、試題循序漸進(jìn)讓新手學(xué)習(xí) React 的基本概念。
「新手入門(mén)」 部分當(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/
