We want to hear from you!Take our 2021 Community Survey!
This site is no longer updated.Go to react.dev

Hook 的規則

Hook 是 React 16.8 新加入的功能,它們讓你可以不用寫 class 就能使用 state 與其他 React 的功能。

Hook 是 JavaScript function,當你使用它們時需要遵守兩個規則。我們提供了一個 linter plugin 來自動化地實行這些規則:

只在最上層呼叫 Hook

不要在迴圈、條件式或是巢狀的 function 內呼叫 Hook。相反的,在任何 early return 之前,請在 React function top level 使用 Hook。藉由遵循這些規則,你可以確保當每次一個 component render 時 Hook 都依照正確的順序被呼叫。正是這個使得 React 有辦法在多個 useStateuseEffect 呼叫間,正確地保持 Hook 的 state。 (如果你感到好奇,我們將在下方深入的解釋它。)

只在 React Function 中呼叫 Hook

別在一般的 JavaScript function 中呼叫 Hook。相反的,你可以:

  • ✅ 在 React function component 中呼叫 Hook。
  • ✅ 在自定義的 Hook 中呼叫 Hook。(我們將會在下一頁了解它們)。

透過遵循這些規則,你確保了在 component 中所有的 stateful 邏輯在其原始碼中可以清楚地被看見。

ESLint Plugin

我們發佈了一個 ESLint plugin 叫做 eslint-plugin-react-hooks 來強制施行這兩個規則。如果你想嘗試的話,可以將這個 plugin 加入到你的專案中:

Create React App 預設包含此 plugin。

npm install eslint-plugin-react-hooks --save-dev
// 你的 ESLint 配置
{
  "plugins": [
    // ...
    "react-hooks"
  ],
  "rules": {
    // ...
    "react-hooks/rules-of-hooks": "error", // 檢查 Hook 的規則
    "react-hooks/exhaustive-deps": "warn" // 檢查 effect 的相依性
  }
}

你現在可以先跳過,下一頁將解釋如何打造你自己的 Hook在這頁,我們將會繼續解釋這些規則背後的原因。

解說

如我們先前所學到的,我們可以在單一的 component 中使用多個 State 或 Effect Hook:

function Form() {
  // 1. 使用 name state 變數
  const [name, setName] = useState('Mary');

  // 2. 使用一個 effect 來保存表單
  useEffect(function persistForm() {
    localStorage.setItem('formData', name);
  });

  // 3. 使用 surname state 變數
  const [surname, setSurname] = useState('Poppins');

  // 4. 使用一個 effect 來更新標題
  useEffect(function updateTitle() {
    document.title = name + ' ' + surname;
  });

  // ...
}

所以 React 是如何知道哪個 state 要對應到哪個 useState 的呼叫?答案是 React 仰賴於 Hook 被呼叫的順序。我們的範例能執行是因為在每一次的 render 中 Hook 都是依照一樣的順序被呼叫:

// ------------
// 第一次 render
// ------------
useState('Mary')           // 1. 用 'Mary' 來初始化 name state 變數
useEffect(persistForm)     // 2. 增加一個 effect 來保存表單
useState('Poppins')        // 3. 用 'Poppins' 來初始化 surname state 變數
useEffect(updateTitle)     // 4. 增加一個 effect 來更新標題

// -------------
// 第二次 render
// -------------
useState('Mary')           // 1. 讀取 name state 變數 (參數被忽略了)
useEffect(persistForm)     // 2. 替換了用來保存表單的 effect
useState('Poppins')        // 3. 讀取 surname state 變數 (參數被忽略了)
useEffect(updateTitle)     // 4. 替換了用來更新標題的 effect

// ...

只要 Hook 在 render 時被呼叫的順序是一致的,React 可以將一些 local state 和它們一一聯繫在一起。但如果我們把一個 Hook 呼叫(例如,persistForm effect)放在條件式中會發生什麼事呢?

  // 🔴 我們違反了第一個規則,在條件式中使用 Hook
  if (name !== '') {
    useEffect(function persistForm() {
      localStorage.setItem('formData', name);
    });
  }

這個 name !== '' 條件式在初次 render 時為 true,所以我們執行了此 Hook。然而,在下一次 render 時使用者可能清除了表單,使得條件式變為 false。而現在我們在 render 期間跳過了這一個 Hook,Hook 的呼叫順序有所不同:

useState('Mary')           // 1. 讀取 name state 變數 (參數被忽略了)
// useEffect(persistForm)  // 🔴 這個 Hook 被跳過了!
useState('Poppins')        // 🔴 2 (但之前是 3). 未能讀取 surname state 變數
useEffect(updateTitle)     // 🔴 3 (但之前是 4). 未能取代 effect

React 不會知道第二個 useState Hook 呼叫回傳什麼。React 預期在這個 component 中的第二個 Hook 呼叫和 persistForm effect 是相對應的,就如同在前一次的 render 一樣,但它不再一樣了。從那時起,在我們跳過的那個 Hook 後面,每下一個 Hook 呼叫都會 shift 一個,導致 bug 的發生。

這就是為何必須在我們的 component 之上層來呼叫 Hook。 如果我們想要有條件地執行 effect,我們可以把那個條件式放在我們的 Hook

  useEffect(function persistForm() {
    // 👍 我們不再違反第一個規則
    if (name !== '') {
      localStorage.setItem('formData', name);
    }
  });

注意你不需要擔心這個問題,如果你使用提供的 lint 規則但現在你也了解為何 Hook 是這樣運作的,和這些用來避免而制定的規則。

下一步

最後, 我們準備好學習撰寫你自己的 Hook!自定義的 Hook 讓你能結合由 React 提供的 Hook 到你自己的抽象化中,而且在不同的 component 間重複使用相同的 stateful 邏輯。

Is this page useful?Edit this page