overview

之前我们介绍了使用hooks的原因,在开始介绍api之前,现在我们先来整体的预览下这些api。 从上篇的介绍可以知道,Hook是向后兼容的,有react开发经验的你看起来会更顺畅。

是一个快节奏的概述。如果你感到困惑,可以看下上面提到的介绍里的动机:

详细说明 阅读动机以了解我们为何将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(我们将在稍后讨论这意味着什么)。可以看到,在这个函数组件里,我们向他添加一些本地状态。React将在重新渲染之间保留这状态。 useState返回一对:当前状态值(count)和允许你更新状态的函数(setCount)。你可以从事件处理程序或其他位置调用此函数。这个函数类似于类中的this.setState,但是它不会将旧状态和新状态合并在一起。(我们将在使用State Hook中显示一个将useStatethis.state进行比较的示例。)

useState的唯一参数是初始状态。 在上面的例子中,它是0,因为我们的计数器从零开始。请注意,与this.state不同,此处的状态不必是对象 - 尽管可以是任何你想要的。初始状态参数仅在第一次渲染期间使用。

声明多个state

你可以在一个组件中多次使用State Hook

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

数组解构语法允许我们为通过调用useState声明的状态变量赋予不同的名称。这些名称不是useState API的一部分。相反,React假定如果多次调用useState,则在每次渲染期间以相同的顺序执行。我们将回到为什么这种方法有效以及何时有用。

什么是Hook

钩子是允许从功能组件(function component)“挂钩”React状态和生命周期功能的功能。钩子在类内部不起作用 - 它们允许你在没有类的情况下使用React (我们不建议你在一夜之间重写现有组件,但如果你愿意,可以开始在新组件中使用Hook。)

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

详细说明 你可以在使用State Hook中了解更多信息。

Effect Hook

你之前可能已经从React组件执行数据提取,订阅或手动更改DOM。我们将这些操作称为“副作用”(或简称为“效果”),因为它们会影响其他组件,并且在渲染过程中无法完成。

Effect Hook中的useEffect增加了在功能组件执行副作用的功能。它与React类中的componentDidMountcomponentDidUpdatecomponentWillUnmount具有相同的用途,但统一为单个API。(我们将在使用Effect Hook时显示将useEffect与这些方法进行比较的示例。)

例如,下面的组件将在React更新DOM后设置文档标题:

import { useState, useEffect } from 'react';

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

  // 类似componentDidMount 和 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的更改后(你可以认为是render之后)。 效果在组件内声明,因此可以访问其propsstate。默认情况下,React在每次渲染后运行效果 - 包括第一次渲染。 (我们将更多地讨论使用effect hook与类生命周期的比较。)

Effects还可以通过指定返回函数来清理他们。看下面的这个例子:

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';
}

在这个示例中,当组件卸载时,以及在由于后续渲染而重新运行效果之前,React将取消订阅我们的ChatAPI。(如果你愿意的话,如果我们传递给ChatAPIprops.friend.id没有改变,有办法告诉React跳过重新订阅。)

就像使用useState一样, 你也可以在组件中使用多个效果:

function FriendStatusWithCounter(props) {
  const [count, setCount] = useState(0);
  useEffect(() => {
    document.title = `You clicked ${count} times`;
  });

  const [isOnline, setIsOnline] = useState(null);
  useEffect(() => {
    ChatAPI.subscribeToFriendStatus(props.friend.id, handleStatusChange);
    return () => {
      ChatAPI.unsubscribeFromFriendStatus(props.friend.id, handleStatusChange);
    };
  });

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

Hooks允许你通过哪些部分相关(例如添加和删除订阅)来组织组件中的副作用,而不是基于生命周期方法强制拆分。

详细说明 你可以在使用Effect Hook中了解更多信息。

Hooks的规则

钩子是JavaScript函数,但它们强加了两个额外的规则:

  • 只能在顶层调用Hooks。不要在循环,条件或嵌套函数中调用Hook

  • 仅从React功能组件调用Hooks 不要从常规JavaScript函数中调用Hook。 (还有另一个有效的地方叫Hooks - 你自己的定制Hooks。我们马上就会了解它们。)

详细说明 你可以在Rules Hook中了解更多信息。

Custom Hooks

有时,我们希望在组件之间重用一些有状态逻辑的部分。传统上,这个问题有两个流行的解决方案:高阶组件渲染道具Custom Hooks允许你执行这样的操作,并且无需向树中添加更多组件。在上面我们介绍了一个调用useStateuseEffect HooksFriendStatus组件来订阅朋友的在线状态。假设我们还希望在另一个组件中重用此订阅逻辑。 首先,我们将这个逻辑提取到一个名为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>
  );
}

这些组件的状态是完全独立的。钩子是重用有状态逻辑的一种方式,而不是状态本身。 事实上,每次调用Hook都有一个完全隔离的状态 - 所以你甚至可以在一个组件中使用相同的自定义Hook两次。

custom hook更像是一种约定而非功能。如果函数的名称以use开头并且它调用其他Hook,我们说它是一个Custom HookuseSomething命名约定是linter插件如何使用Hooks在代码中查找错误的。

详细说明 你可以在Writing Custom Hooks中了解更多信息。

Other Hooks

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

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

useReducer允许使用reducer管理复杂组件的本地状态:

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

详细说明 你可以在 Hooks API Reference.中了解更多信息。

hooks系列地址,欢迎watch

本文原文档

Last updated