Skip to content

Commit b941542

Browse files
chore: formatting docs
1 parent f9455ad commit b941542

File tree

1 file changed

+12
-13
lines changed

1 file changed

+12
-13
lines changed

src/content/learn/keeping-components-pure.md

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ title: 保持 Component 的 Pure
66

77
有些 JavaScript 的函式為「純函式」。純函式只會執行計算,不會做別的事情。如果我們嚴格地把 component 都寫成純函式,就可以在隨著 codebase 的增長中避免一系列令人困惑且不可預期的問題出現。但是在獲得這些好處前,你必須先遵守一些規則。
88

9-
109
</Intro>
1110

1211
<YouWillLearn>
@@ -53,7 +52,7 @@ React 就是圍繞這個概念設計的。**React 假設你編寫的每個函式
5352
```js App.js
5453
function Recipe({ drinkers }) {
5554
return (
56-
<ol>
55+
<ol>
5756
<li>Boil {drinkers} cups of water.</li>
5857
<li>Add {drinkers} spoons of tea and {0.5 * drinkers} spoons of spice.</li>
5958
<li>Add {0.5 * drinkers} cups of milk to boil and sugar to taste.</li>
@@ -82,7 +81,7 @@ export default function App() {
8281

8382
就像是數學公式一樣。
8483

85-
你可以把 component 想成是食譜一樣: 如果你遵循它們並且在烹飪過程中不加入新食材,那麼你每次都會得到相同的菜餚。這個「菜餚」就是 component 提供給 React [render](/learn/render-and-commit) 的 JSX。
84+
你可以把 component 想成是食譜一樣: 如果你遵循它們並且在烹飪過程中不加入新食材,那麼你每次都會得到相同的菜餚。這個「菜餚」就是 component 提供給 React [render](/learn/render-and-commit) 的 JSX。
8685

8786
<Illustration src="/images/docs/illustrations/i_puritea-recipe.png" alt="A tea recipe for x people: take x cups of water, add x spoons of tea and 0.5x spoons of spices, and 0.5x cups of milk" />
8887

@@ -144,7 +143,7 @@ export default function TeaSet() {
144143

145144
現在你的 component 是 pure 的,因為它回傳的 JSX 僅依賴 `guest` prop。
146145

147-
一般來說,你不應該預期 component 以任何特定順序 render 。在 <Math><MathI>y</MathI> = 2<MathI>x</MathI></Math> 之前或之後調用 <Math><MathI>y</MathI> = 5<MathI>x</MathI></Math> 並不重要:兩個公式都將各自獨立地求解。同樣的,每個 component 都應該「只考慮自己」,而不是在 rendering 過程中試圖與其他 component 協調或是依賴其他 component。Rendering 就像是一個學校考試:每個 component 都應該計算自己的 JSX!
146+
一般來說,你不應該預期 component 以任何特定順序 render。在 <Math><MathI>y</MathI> = 2<MathI>x</MathI></Math> 之前或之後調用 <Math><MathI>y</MathI> = 5<MathI>x</MathI></Math> 並不重要:兩個公式都將各自獨立地求解。同樣的,每個 component 都應該「只考慮自己」,而不是在 rendering 過程中試圖與其他 component 協調或是依賴其他 component。Rendering 就像是一個學校考試:每個 component 都應該計算自己的 JSX!
148147

149148
<DeepDive>
150149

@@ -188,13 +187,13 @@ export default function TeaGathering() {
188187

189188
如果 `cups` 變數或者是 `[]` array 是在 `TeaGathering` 函式之外建立的,這就會是個大問題!你會在將項目放入 array 時改變一個*預先存在的* object。
190189

191-
不過,由於你是在 `TeaGathering` 內的 *同個 render 過程中* 建立它們的,所以不會有問題。在 `TeaGathering` 範圍外的任何程式碼都不會知道發生了這個情況。這稱為 **「local mutation」**- 這就像是 component 自己的小秘密。
190+
不過,由於你是在 `TeaGathering` 內的*同個 render 過程中*建立它們的,所以不會有問題。在 `TeaGathering` 範圍外的任何程式碼都不會知道發生了這個情況。這稱為 **「local mutation」**- 這就像是 component 自己的小秘密。
192191

193192
## 你_可能_會引起 side effects 的地方 {/*where-you-_can_-cause-side-effects*/}
194193

195-
雖然函數式程式設計在很大程度上依賴 purity,但在某些時候,_有些東西_ 必須改變。這就是程式設計的意義所在!這些更改例如:顯示畫面、開始一個動畫、更改資料都被稱為 **side effects**他們是 _一邊發生_ 的事情,而不是在 render 期間發生的事情。
194+
雖然函數式程式設計在很大程度上依賴 purity,但在某些時候,_有些東西_必須改變。這就是程式設計的意義所在!這些更改例如:顯示畫面、開始一個動畫、更改資料都被稱為 **side effects**他們是_一邊發生_的事情,而不是在 render 期間發生的事情。
196195

197-
在 React 中,**side effects 通常屬於 [event handler](/learn/responding-to-events)**。Event handler 是 React 在你執行某些操作(例如:點擊一個按鈕)時執行的函式。儘管 event handler 是在 component *內部* 定義的,但它們 *不會在 render 時間執行***所以 event handler 不需要是 pure 的。**
196+
在 React 中,**side effects 通常屬於 [event handler](/learn/responding-to-events)**。Event handler 是 React 在你執行某些操作(例如:點擊一個按鈕)時執行的函式。儘管 event handler 是在 component *內部*定義的,但它們*不會在 render 時間執行***所以 event handler 不需要是 pure 的。**
198197

199198
如果你已經用盡了所有其他選項,並且無法找到其他適合你的 side effect 的 event handler,你仍然可以選擇 component 中的 [`useEffect`](/reference/react/useEffect) 來將其附加到回傳的 JSX。這告訴 React 在 render 後、允許 side effect 的情況下執行它。**但是,這個方法應該要是你最後的手段。**
200199

@@ -206,7 +205,7 @@ export default function TeaGathering() {
206205

207206
撰寫純函式需要一些習慣與紀律。但純函式也解鎖了一些絕佳的功能:
208207

209-
* 你的 component 可以在不同環境上運行 - 例如,在伺服器上!由於它們對相同輸出會有相同結果,因此一個 component 可以滿足許多使用者請求。
208+
* 你的 component 可以在不同環境上執行 - 例如,在伺服器上!由於它們對相同輸出會有相同結果,因此一個 component 可以滿足許多使用者請求。
210209
* 你可以透過 [skipping rendering](/reference/react/memo) 那些 input 沒有更新的 component 來提升效能。這是安全的,因為純函式永遠都會回傳相同的結果,所以可以安全地 cache 它們。
211210
* 如果在 render 一個 deep component tree 的過程中某些資料發生變化,React 可以重新進行 render、而不浪費時間完成過時的 render。Purity 可以讓它更安全地隨時停止計算。
212211

@@ -220,14 +219,14 @@ export default function TeaGathering() {
220219
* **只關心自己的事務。** 這個函式不會修改任何在他被呼叫之前就已經存在的 object 或變數。
221220
* **一樣的輸入,一樣的輸出** 只要我們輸入相同的參數,這個函式總是回傳一個相同的輸出。
222221
* Rendering 可能會在任何時間發生,因此 component 不該依賴於彼此的 rendering 順序。
223-
* 你不該改變任何你的 component 用來 render 的輸入。這包含 props,state,以及 context。要更新畫面的話,請 ["set" state](/learn/state-a-components-memory) 而不是直接修改預先存在的 object。
222+
* 你不該改變任何你的 component 用來 render 的輸入。這包含 props,state,以及 context。要更新畫面的話,請 [set state](/learn/state-a-components-memory) 而不是直接修改預先存在的 object。
224223
* 盡量在回傳的 JSX 中表達你的 component 邏輯。當你需要「更改內容」時,你會希望在 event handler 中處理。或是作為最後的手段,你可以使用 `useEffect`
225224
* 撰寫純函式需要一些練習,不過它能解鎖 React 典範的力量。
226225

227226
</Recap>
228227

229228

230-
229+
231230
<Challenges>
232231

233232
#### 修正一個換掉的時鐘 {/*fix-a-broken-clock*/}
@@ -238,7 +237,7 @@ export default function TeaGathering() {
238237

239238
<Hint>
240239

241-
Render 是一種 *計算* ,它不應該嘗試「做」事情。你能用不同方式表達同一種想法嗎?
240+
Render 是一種*計算* ,它不應該嘗試「做」事情。你能用不同方式表達同一種想法嗎?
242241

243242
</Hint>
244243

@@ -476,7 +475,7 @@ h1 { margin: 5px; font-size: 18px; }
476475

477476
<Solution>
478477

479-
問題在於 `Profile` component 修改一個稱為 `currentPerson` 的預先存在的變數,而 `Header` and `Avatar` component 都有讀取這個變數。這導致 *它們三個* 都變得 impure 且難以預測。
478+
問題在於 `Profile` component 修改一個稱為 `currentPerson` 的預先存在的變數,而 `Header` `Avatar` component 都有讀取這個變數。這導致*它們三個*都變得 impure 且難以預測。
480479

481480
要修正這個錯誤,請先刪除 `currentPerson` 變數。並且改成透過 props 將所有資料從 `Profile` 傳送到 `Header``Avatar`。你會需要會兩個 component 添加一個 `person` prop 並把它一直向下傳遞。
482481

@@ -676,7 +675,7 @@ li {
676675

677676
<Solution>
678677

679-
請注意,每當時鐘更新時,"Create Story" 就會被增加 *兩次* 。這暗示我們在 render 過程中發生了一個變異 -- Strict Mode 調用了兩次 component 使得這個問題更明顯。
678+
請注意,每當時鐘更新時,Create Story就會被增加*兩次* 。這暗示我們在 render 過程中發生了一個變異 -- Strict Mode 調用了兩次 component 使得這個問題更明顯。
680679

681680
`StoryTray` 函式不是 pure 的。透過在接收到的 `stories` array(一個 prop )呼叫 `push` ,它會改變在 `StoryTray` render 前就建立的 object 。這使得它變得充滿錯誤並且難以預測。
682681

0 commit comments

Comments
 (0)