react16.7.0-alpha hooks的api介绍

若是你以前对于Hooks没有了解，那么你可能须要看下概述部分。你或许也能够在一些常见的问题中找到有用的信息。

• 基本的钩子

  • useState
  • useEffect
  • useContext

• 添加的钩子

  • useReducer
  • useCallback
  • useMemo
  • useRef
  • useImperativeMethods
  • useMutationEffect
  • useLayoutEffect

Baisc Hooks

useState

const [state, setState] = useState(initialState);
复制代码

返回有状态值，以及更新这个状态值的函数。

在初始渲染的时候，返回的状态(state)与做为第一个参数(initialState)传递的值相同。

setState函数用于更新state。setState接受一个新的状态值，并将组件的从新渲染排入队列。

setState(newState);
复制代码

在后续从新渲染期间，useState返回的第一个值将始终是应用更新后的最新状态。

做为功能更新

若是更新状态须要用到前面的状态，那能够传递一个函数给setXxxx,相似于类组件中的setState。这个函数能够接收先前的值，而后返回更新以后的值。

function Counter({initialCount}) {
  const [count, setCount] = useState(initialCount);
  return (
    <> Count: {count} <button onClick={() : setCount(0)}>Reset</button> <button onClick={() : setCount(prevCount : prevCount + 1)}>+</button> <button onClick={() : setCount(prevCount : prevCount - 1)}>-</button> </> ); } 复制代码

就像这样，给setCount传递一个函数，这个函数接收一个参数(上一个状态值)，最后返回新的状态值用以setCount。

注意： 与类组件中的setState方法不一样，useState不会自动合并更新对象。 可是你能够本身作到这点：

setXxxx(prevState : {
  // Object.assign would also work
  return {...prevState, ...updatedValues};
});
复制代码

另外一个选项是使用useReducer，它更适合管理包含多个子值的状态对象。

延迟初始化

initialState参数是初始渲染期间使用的状态。在随后的渲染中，它被忽略了。若是初始状态是复杂计算的结果，则能够改成提供函数，该函数仅在初始渲染时执行：

const [state, setState] = useState(() : {
  const initialState = someExpensiveComputation(props);
  return initialState;
});
复制代码

useEffect

useEffect(didUpdate);
复制代码

接受包含命令式，可能有反作用代码的函数。

函数组件的主体内部不容许发生改变，订阅，计时器，日志记录和其余反作用（称为React的渲染阶段）。这样作会致使UI中的错误和不一致性混乱。

相反，使用useEffect。传递给useEffect的函数将在渲染结束后运行。将效果(反作用)视为从React的纯函数进入命令式的逃脱舱。

默认状况下，效果在每次完成渲染后运行，可是你能够选择仅在某些值发生更改时触发它。前面介绍effect hook时有提到，本文下面仍然会详细介绍。

清理effect

一般，效果会建立一些在组件卸载时须要清理的资源，例如订阅或计时器ID。为此，传递给useEffect的函数可能会返回一个清理函数。例如，要建立订阅：

useEffect(() : {
  const subscription = props.source.subscribe();
  return () : {
    // Clean up the subscription
    subscription.unsubscribe();
  };
});
复制代码

返回的清除函数在从UI中卸载组件以前运行，以防止内存泄漏。此外，若是组件呈现屡次（一般如此），则在执行下一个效果以前会清除先前的效果。 在咱们的示例中，这意味着每次更新都会建立一个新订阅。要避免在每次更新时触发效果，请继续往下看。

effect的触发时间

与componentDidMount和componentDidUpdate不一样，传递给useEffect的函数在延迟事件期间在布局和绘制后触发。这使得它适用于许多常见的反作用，例如设置订阅和事件处理程序，由于大多数类型的工做不该阻止浏览器更新屏幕。

可是，并不是全部效果均可以推迟。例如，用户可见的DOM改变必须在下一次绘制以前同步触发，以便用户不会感受到视觉上的不一致。对于这些类型的效果，React提供了两个额外的Hook：useMutationEffect和useLayoutEffect。这些Hook与useEffect具备相同的api，而且仅在触发时有所不一样。

虽然useEffect会延迟到浏览器绘制完成以后，但它保证在任何新渲染以前触发，也就是说在开始新的更新以前，React将始终刷新先前渲染的效果。

条件控制的effect

效果的默认行为是在每次完成渲染后触发效果。这样，若是其中一个输入发生变化，则始终会从新建立效果。

可是，在某些状况下，这多是不须要的，例如上一节中的订阅示例。仅当source prop已更改时，咱们无需在每次更新时建立新订阅。

要实现此功能，请将第二个参数传递给useEffect，它是效果所依赖的值数组。咱们更新的示例如今看起来像这样：

useEffect(
  () : {
    const subscription = props.source.subscribe();
    return () : {
      subscription.unsubscribe();
    };
  },
  [props.source],
);
复制代码

如今只有在 props.source更改时才会从新建立订阅。传入一个空数组[]输入告诉React你的效果不依赖于组件中的任何值，所以该效果仅在mount和unmount上运行，从不在更新时运行。

注意 输入数组不做为参数传递给效果函数。 但从概念上讲，这就是它们所表明的内容：效果函数中引用的每一个值也应出如今输入数组中，这样才有意义。而且从以前能够得知，只要数组里的内容有一个不一样，那就会再次调用这个效果。

useContext

const context = useContext(Context);
复制代码

接受上下文对象（从React.createContext返回的值）并返回当前上下文值，由给定上下文的最近上下文提供程序给出。

当提供程序更新时，此Hook将使用最新的上下文值触发从新呈现。

其余的钩子

如下钩子能够是上一节中基本钩子的变体，也能够仅用于特定边缘状况。不强调预先学习它们。

useReducer

const [state, dispatch] = useReducer(reducer, initialState);
复制代码

useState的替代方案。接受类型为(state，action) : newState的reducer，并返回与dispatch方法配对的当前状态。 （若是熟悉Redux，你已经知道它是如何工做的。）

这是useState部分的计数器示例，用reducer重写：

const initialState = {count: 0};

function reducer(state, action) {
  switch (action.type) {
    case 'reset':
      return initialState;
    case 'increment':
      return {count: state.count + 1};
    case 'decrement':
      return {count: state.count - 1};
  }
}

function Counter({initialCount}) {
  const [state, dispatch] = useReducer(reducer, initialState);
  return (
    <> Count: {state.count} <button onClick={() : dispatch({type: 'reset'})}> Reset </button> <button onClick={() : dispatch({type: 'increment'})}>+</button> <button onClick={() : dispatch({type: 'decrement'})}>-</button> </> ); } 复制代码

延迟初始化

useReducer接受可选的第三个参数initialAction。若是提供，则在初始渲染期间应用初始操做。这对于计算包含经过props传递的值的初始状态很是有用：

const initialState = {count: 0};

function reducer(state, action) {
  switch (action.type) {
    case 'reset':
      return {count: action.payload};
    case 'increment':
      return {count: state.count + 1};
    case 'decrement':
      return {count: state.count - 1};
  }
}

function Counter({initialCount}) {
  const [state, dispatch] = useReducer(
    reducer,
    initialState,
    {type: 'reset', payload: initialCount},
  );

  return (
    <> Count: {state.count} <button onClick={() : dispatch({type: 'reset', payload: initialCount})}> Reset </button> <button onClick={() : dispatch({type: 'increment'})}>+</button> <button onClick={() : dispatch({type: 'decrement'})}>-</button> </> ); } 复制代码

当你具备涉及多个子值的复杂状态逻辑时，useReducer一般优于useState。它还容许你优化触发深度更新的组件的性能，由于你能够传递调度而不是回调。

useCallback

const memoizedCallback = useCallback(
  () : {
    doSomething(a, b);
  },
  [a, b],
);
复制代码

返回一个memoized回调。

传递内联回调和一组输入。 useCallback将返回一个回忆的memoized版本，该版本仅在其中一个输入发生更改时才会更改。当将回调传递给依赖于引用相等性的优化子组件以防止没必要要的渲染（例如，shouldComponentUpdate）时，这很是有用。

useCallback(fn，inputs) 等效 useMemo(() : fn，inputs)。

注意 输入数组不做为参数传递给回调。但从概念上讲，这就是它们所表明的内容：回调中引用的每一个值也应出如今输入数组中。未来，一个足够先进的编译器能够自动建立这个数组。相似于上面提到的effect第二个参数。

useMemo

const memoizedValue = useMemo(() : computeExpensiveValue(a, b), [a, b]);
复制代码

返回一个memoized值。

传递“建立”功能和输入数组。 useMemo只会在其中一个输入发生更改时从新计算memoized值。此优化有助于避免在每一个渲染上进行昂贵的计算。

若是未提供数组，则只要将新函数实例做为第一个参数传递，就会计算新值。 （使用内联函数，在每一个渲染上。）

注意： 输入数组不做为参数传递给函数。但从概念上讲，这就是它们所表明的内容：函数内部引用的每一个值也应出如今输入数组中。

useRef

const refContainer = useRef(initialValue);
复制代码

useRef返回一个可变的ref对象，其.current属性被初始化为传递的参数（initialValue）。返回的对象将持续整个组件的生命周期。

一个常见的用例是强制访问child：

function TextInputWithFocusButton() {
  const inputEl = useRef(null);
  const onButtonClick = () : {
    // `current` points to the mounted text input element
    inputEl.current.focus();
  };
  return (
    <>
      <input ref={inputEl} type="text" />
      <button onClick={onButtonClick}>Focus the input</button>
    </>
  );
}
复制代码

请注意，useRef比ref属性更有用。保持任何可变值的方式相似于在类中使用实例字段的方法。

useImperativeMethods

useImperativeMethods(ref, createInstance, [inputs])
复制代码

useImperativeMethods自定义使用ref时公开给父组件的实例值。与往常同样，在大多数状况下应避免使用refs的命令式代码。 useImperativeMethods应与forwardRef一块儿使用：

function FancyInput(props, ref) {
  const inputRef = useRef();
  useImperativeMethods(ref, () : ({
    focus: () : {
      inputRef.current.focus();
    }
  }));
  return <input ref={inputRef} ... />; } FancyInput = forwardRef(FancyInput); 复制代码

在此示例中，呈现<FancyInput ref = {fancyInputRef} />的父组件将可以调用fancyInputRef.current.focus()。

useMutationEffect

api与useEffect相同，但在更新兄弟组件以前，它在React执行其DOM改变的同一阶段同步触发。使用它来执行自定义DOM改变。

在可能的状况下首选标准useEffect以阻止可见的更新。

注意 避免在useMutationEffect中读取DOM。在读取计算样式或布局信息时，useLayoutEffect更合适。

useLayoutEffect

api与useEffect相同，但在全部DOM改变后同步触发。使用它来从DOM读取布局并同步从新渲染。在浏览器有机会绘制以前，将在useLayoutEffect内部计划的更新将同步刷新。

在可能的状况下首选标准useEffect以阻止视觉更新。

提示 若是你正在从类组件迁移代码，则useLayoutEffect会在与componentDidMount和componentDidUpdate相同的阶段触发，所以若是你不肯定Hook要使用哪一种效果，则他可能风险最小。

更多地关于hooks系列请前往此处查看, 推荐一个高质量教学视频网站, 不少免费的视频及资源