Hooks概览（译）

Hooks是React v16.7.0-alpha中加入的新特性。它可以让你在class以外使用state和其他React特性。你可以在这里看到关于它的一些讨论。

Hooks 向后兼容。本页向有经验的 React 用户提供 Hooks 的概览。

这是一个快节奏的概览。如果你感到困惑，请在以下方框中获取更多相关内容：

详细解释 阅读动机以了解我们为何将Hooks引入React

每个部分都以上面这样的方框结束。它们链接到详细的解释。

State Hook

以下示例渲染一个计数器。点击按钮，数值递增：

import { useState } from 'react';

function Example() {
  // Declare a new state variable, which we'll call "count"
  const [count, setCount] = useState(0);

  return (
    <div>
      <p>You clicked {count} times</p>
      <button onClick={() => setCount(count + 1)}>
        Click me
      </button>
    </div>
  );
}

这里，useState是一个Hook（稍后将会讨论它的含义）。在函数组件中调用useState来向它添加一些本地state。React将在重新渲染之间保留此状态。useState返回一对值：当前 state 值和一个用于更新这个值的函数。可以在事件处理程序或者其它地方调用这个函数。它类似于类中的this.setState。不同的是它不能将旧的state和新的state合并在一起。（我们将提供一个示例，用State Hook对useState和this.state进行比较。）

useState的唯一参数用于初始化state。在上面的例子中，这个初始值是0，因为计数器从0开始。请注意，与this.state不同的是，此处的state 不必是对象——尽管它支持对象类型。这个初始化state的参数仅在第一次渲染被使用。

声明多个state变量

可以在单个组件中多次使用State Hook：

function ExampleWithManyStates() {
  // Declare multiple state variables!
  const [age, setAge] = useState(42);
  const [fruit, setFruit] = useState('banana');
  const [todos, setTodos] = useState([{ text: 'Learn Hooks' }]);
  // ...
}

数组解构语法允许我们在调用useState时将声明的state变量赋予不同的名称。这些名称不是useState API的一部分。相反，React假定如果多次调用useState，则在每次渲染时以相同的顺序执行。 我们稍后将讨论为什么这种方法可行以及何时有用。

Hook是什么？

Hooks是一个“钩住”React state和生命周期特性的函数组件。Hooks在类中不起作用——它们让你在没有类的情况下使用React。（不建议一夜之间重写现有组件，但如果你愿意，可以开始在新组件中使用 Hooks。）

React提供了一些像useState这样的内置Hook。你还可以创建自己的Hook以复用不同组件之间的状态行为。我们先来看看内置的Hooks。

详细解释 你可以在专属页上了解有关State Hook的更多信息：使用State Hook。

Effect Hook

你之前可能从React组件执行过数据获取、订阅或手动更改DOM。我们将这些操作称为“副作用”（或简称为“影响”）（side effects），因为它们会影响其他组件，并且在渲染过程中无法完成。

Effect Hook、useEffect增加了从功能组件执行副作用的功能。它与React类中的componentDidMount，componentDidUpdate和componentWillUnmount具有相同的用途，但统一为单个API。（我们将在使用Effect Hook中提供示例，将useEffect和这些方法进行比较。）

例如，组件在React更新DOM之后设置文档标题：

import { useState, useEffect } from 'react';

function Example() {
  const [count, setCount] = useState(0);

  // Similar to componentDidMount and componentDidUpdate:
  useEffect(() => {
    // Update the document title using the browser API
    document.title = `You clicked ${count} times`;
  });

  return (
    <div>
      <p>You clicked {count} times</p>
      <button onClick={() => setCount(count + 1)}>
        Click me
      </button>
    </div>
  );
}

 当调用useEffect时，React被告知在刷新对DOM的更改后运行“影响”（effect）函数。Effects函数在组件内被声明，因此可以访问其props和state。默认情况下，React在每次渲染后都运行effects函数——包括第一次渲染。 （我们将在使用Effect Hook章节中更多地讨论这与类中的生命周期的比较。）

Effects还可以通过返回函数指定如何“清理”它们。例如，一个组件使用 effect来订阅朋友的在线状态，并通过取消订阅来清理它：

import { useState, useEffect } from 'react';

function FriendStatus(props) {
  const [isOnline, setIsOnline] = useState(null);

  function handleStatusChange(status) {
    setIsOnline(status.isOnline);
  }

  useEffect(() => {
    ChatAPI.subscribeToFriendStatus(props.friend.id, handleStatusChange);

    return () => {
      ChatAPI.unsubscribeFromFriendStatus(props.friend.id, handleStatusChange);
    };
  });

  if (isOnline === null) {
    return 'Loading...';
  }
  return isOnline ? 'Online' : 'Offline';
}

在此例中，当组件卸载，以及由于后续渲染而重新运行这个effect之前，React将从ChatAPI取消订阅。（如果传递到ChatAPI的props.friend.id没有改变，有一种方法可以让 React跳过重新订阅。）

Hooks允许通过那些相关的部分（例如添加和删除订阅）来组织组件中的副作用（side effects），而不是基于生命周期方法强制拆分。

详细解释 你可以在专属页上了解有关useEffect的更多信息：使用Effect Hook。

Hooks 规范

Hooks是JavaScript函数，但它们强加了两个额外的规则：

• 只能在函数的顶层调用Hooks。不要在循环、条件或嵌套函数中调用Hook。
• 只能在React的函数组件中调用Hooks，不能在常规JavaScript函数调用。（还有另一个调用Hooks的有效方式：自定义Hooks。稍后将会介绍它们。）

我们提供了一个linter插件来自动执行这些规则。这些规则最初可能看起来是一种限制或令人困惑，但它们对于使Hooks运行良好必不可少。

详细解释 你可以在专属页上了解有关规范的更多信息：Hook规范。

自定义Hooks

有时，我们希望在组件之间复用一些状态逻辑。这个问题在传统方式上有两种流行的解决方案：高阶组件和render props。自定义Hooks可以解决这个问题，且无需向树中添加更多组件。

在本页前面，我们介绍了一个调用useState和useEffect Hooks的FriendStatus组件来订阅朋友的在线状态。我们希望在另一个组件中复用此订阅逻辑。

首先，我们将这个逻辑提取到一个名为useFriendStatus的自定义Hook中：

import { useState, useEffect } from 'react';

function useFriendStatus(friendID) {
  const [isOnline, setIsOnline] = useState(null);

  function handleStatusChange(status) {
    setIsOnline(status.isOnline);
  }

  useEffect(() => {
    ChatAPI.subscribeToFriendStatus(friendID, handleStatusChange);
    return () => {
      ChatAPI.unsubscribeFromFriendStatus(friendID, handleStatusChange);
    };
  });

  return isOnline;
}

 它将friendID作为参数，并返回我们的朋友是否在线。

现在我们可以在两个组件中使用它：

function FriendStatus(props) {
  const isOnline = useFriendStatus(props.friend.id);

  if (isOnline === null) {
    return 'Loading...';
  }
  return isOnline ? 'Online' : 'Offline';
}

function FriendListItem(props) {
  const isOnline = useFriendStatus(props.friend.id);

  return (
    <li style={{ color: isOnline ? 'green' : 'black' }}>
      {props.friend.name}
    </li>
  );
}

这些组件的状态是完全独立的。Hooks这种方式是复用状态逻辑，而不是state本身。实际上，每次调用Hook都是一个完全隔离的状态，所以你甚至可以在一个组件中两次调用相同的自定义Hook。

自定义Hooks更像是一种约定而非功能。如果函数的名称以“use”开头并且它可以调用其他Hook，则称之为自定义Hook。useSomething命名约定是为了让linter插件在使用Hooks的代码中查找错误。

自定义Hook应用广泛，如表单处理、动画、声明订阅、计时器，以及可能还有更多我们没有考虑到的。 我们很高兴地期待React社区将提出什么样的自定义Hooks。

详细解释 你可以在专属页上了解有关自定义Hooks的更多信息：自定义Hooks。

其它Hooks

你可能会发现一些不太常用的内置Hook很有用。例如，useContext允许你订阅React上下文而不用引入嵌套。

function Example() {
  const locale = useContext(LocaleContext);
  const theme = useContext(ThemeContext);
  // ...
}

 useReducer允许你使用reducer管理复杂组件的本地state：

function Todos() {
  const [todos, dispatch] = useReducer(todosReducer);
  // ...

详细解释 你可以在专属页上了解更多有关内置Hooks的信息：Hooks API参考。

下一步

这一页都是一些概括性的介绍。如果有些地方不了解或者想详细了解更多内容，请阅读下面的章节，从State Hook文档开始。

你还可以查看Hooks API参考和Hooks常见问题解答。

最后，不要错过介绍页，它解释了为什么我们要添加Hooks以及我们如何开始将它们与类一起使用而无需重写我们的应用程序。