React / 系统课时

Hook 的输入与返回值

Hook 的输入与返回值

自定义 Hook 的价值不只在于复用代码,更在于提供清晰的状态接口。本课用一个带边界的计数 Hook,演示如何设计参数、默认值、返回对象和稳定操作函数,让调用者容易理解、测试和扩展。

学习目标

  • 为 Hook 设计语义明确的输入参数
  • 选择适合的返回值结构
  • 保持操作函数稳定并隐藏内部实现

从调用方式反推接口

Hook 名称必须以 use 开头,输入应描述调用者真正关心的配置,而不是暴露内部 state。参数较多时使用选项对象,既能提供默认值,也能避免调用处依赖位置顺序。自定义 Hook 复用的是状态逻辑,各组件仍拥有彼此独立的状态。:contentReference[oaicite:1]{index=1}

返回值有两种常见形式:短小且顺序固定的接口可返回数组;字段较多、含多个操作函数时更适合返回对象。对象字段名能直接表达用途,也便于以后增加能力。

设计一个带边界的计数 Hook

jsx
import { useCallback, useMemo, useState } from 'react';

function useCounter({
  initialValue = 0,
  min = Number.NEGATIVE_INFINITY,
  max = Number.POSITIVE_INFINITY,
  step = 1,
} = {}) {
  const clamp = useCallback(
    (value) => Math.min(max, Math.max(min, value)),
    [min, max]
  );

  const [count, setCount] = useState(() => clamp(initialValue));

  const increment = useCallback(() => {
    setCount((current) => clamp(current + step));
  }, [clamp, step]);

  const decrement = useCallback(() => {
    setCount((current) => clamp(current - step));
  }, [clamp, step]);

  const reset = useCallback(() => {
    setCount(clamp(initialValue));
  }, [clamp, initialValue]);

  return useMemo(
    () => ({ count, increment, decrement, reset }),
    [count, increment, decrement, reset]
  );
}

export default function App() {
  const counter = useCounter({
    initialValue: 2,
    min: 0,
    max: 5,
    step: 1,
  });

  return (
    <main>
      <p>当前值:{counter.count}</p>
      <button onClick={counter.decrement}>减少</button>
      <button onClick={counter.increment}>增加</button>
      <button onClick={counter.reset}>重置</button>
    </main>
  );
}

预期结果:

text
计数初始为 2,只能在 0 到 5 之间变化。
“增加”“减少”和“重置”分别执行对应操作,超过边界时数值保持不变。

稳定性应该稳定什么

示例用 useCallback 保持操作函数在依赖不变时引用稳定,方便调用者把函数传给经过记忆化的子组件。返回对象仍会在 count 变化时更新,这是必要行为;不要为了“永远不变”而让返回值失去响应性。

输入对象本身不应直接作为 Effect 依赖,因为调用者可能在每次渲染时创建新对象。应像示例一样解构出真正参与逻辑的标量值,再将这些值作为依赖。

隐藏实现并暴露能力

调用者只需要知道当前值和可执行操作,不需要知道 Hook 内部使用 useState、useReducer 还是其他机制。返回原始 setCount 会让调用者绕过边界规则,因此更好的接口是暴露 increment、decrement 和 reset 这类领域操作。

测试时可通过一个最小组件使用 Hook,模拟点击并断言页面结果。重点验证公开行为,例如边界限制和重置结果,而不是断言内部调用了哪个 React Hook。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Hook 的输入与返回值

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通