The Difference Between watch and useWatch in React Hook Form

watch 与 useWatch 在 react hook form 中的区别

前言

写这篇文章是因为有同学在课程中问起 watch 与 useWatch 的区别。第一次回答时,我只是简单看了一下文档,事后才发现之前的回答误导了同学,因此写下这篇文章,详细记录它们的区别,希望不再犯同样的错误 😐。

watch 的用途与实际案例?

监听特定的输入并返回它们的值。它在渲染输入值时很有用,也可以用来根据条件决定渲染什么。

根据官方的简要说明,就是:「监听表单变化,并在变化时执行某些操作」。那么在实际场景中,什么时候会需要用到这个方法?除了官方提供的实际案例🔗之外,我也会在这里列举两种官方提供的用法,并实际写一遍看看~

案例一:选择付款方式,显示对应的付款字段

这时就可以用 watch 来监听 paymentMethod 值的变化,选择货到付款时就显示货到付款的字段,选择信用卡付款时就显示信用卡付款的字段,选择转账付款时就显示转账付款的字段……以此类推。

const { register, handleSubmit, watch } = useForm({
defaultValues: {
paymentMethod: 'cashOnDelivery',
},
});
// 监听表单中 hasCreditCard 的值,并解构出来使用
const [paymentMethod] = watch(['paymentMethod']);
return (
<form onSubmit={handleSubmit((data) => console.log(data))}>
<label>
付款方式:
<select {...register('paymentMethod')}>
<option value="cashOnDelivery">货到付款</option>
<option value="creditCard">信用卡</option>
</select>
</label>
{paymentMethod === 'creditCard' && <div>信用卡支付详情……</div>}
{paymentMethod === 'cashOnDelivery' && <div>货到付款支付详情……</div>}
</form>
);

除了上面的案例中监听单个字段外,也可以像下面的示例一样监听多个字段。

const watchAllFields = watch(); // 不传入参数时,监听所有字段的变化
const watchFields = watch(['firstName', 'lastName']); // 指定需要监听的值

watch 实际上就像是帮我们封装好了 useState 和 onChange 的组合,只要传入需要监听的字段数据,就可以监听表单的变化,并在变化时执行某些操作。这种方法可以让复杂表单中的代码更加精简易懂。

// 用传统方法创建一个普通的受控表单
const [name, setName] = useState('');
<input type="text" value={name} onChange={(e) => setName(e.target.value)} />;
渲染次數:2

案例二:监听但不触发重新渲染

如果你只是想监听表单的变化,但不想触发重新渲染,就可以将 watch 与 useEffect 配合使用,监听表单变化而不触发重新渲染。

useEffect(() => {
const subscription = watch((data) => {
console.log(data);
});
return () => subscription.unsubscribe();
}, [watch]);

需要特别注意,如果给 watch 传入了回调函数,就需要使用 useEffect 的清理函数来取消订阅

useWatch 的用途与实际案例?

基本上与 watch 相似,区别在于它会将重新渲染隔离在该 Hook 所在的层级,并有可能提升应用程序的性能。

前面提到,watch 用起来就像是 useState 与 onChange 的组合,只要表单的值发生变化,就会触发该 useForm 所在层级的重新渲染,一旦表单变得复杂,就会遇到性能瓶颈。

因此,useWatch 就是为解决这个问题而生的。只要监听的值发生变化,它就只会触发该 useWatch 所在层级的重新渲染,而不是整个表单的根组件。以下是实际示例:

// 定义在组件之外的变量,用于记录渲染次数
let childRender = 0;
let parentRender = 0;
// 子组件,使用 useWatch 监听表单中 lastName 的值
function Child({ control }) {
useWatch({
control,
name: 'lastName',
});
childRender += 1;
return <p>子组件渲染次数: {childRender}</p>;
}
// 父组件,使用 useWatch 监听表单中 firstName 的值
function Parent() {
const { register, control } = useForm();
useWatch({
name: 'firstName',
control,
});
parentRender += 1;
return (
<form>
<input {...register('firstName')} placeholder="firstName" />
<input {...register('lastName')} placeholder="lastName" />
<p>父组件渲染次数: {parentRender}</p>
<FirstNameWatched control={control} />
</form>
);
}

父元件渲染次數: 2

子元件渲染次數: 2

在示例中,我们在哪个组件里使用 useWatch,就会从哪个组件开始重新渲染。因此,即使子组件监听的值发生变化,也不会让父组件重新渲染,这样就可以提升性能。

总结

useWatch 与 watch 的区别仅在于它们触发重新渲染的层级。如果程序本身没有性能问题,使用 watch 就足够了;如果存在性能问题,就可以使用 useWatch 来解决。

参考资料