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。
按自己的节奏,确认真正理解。