React Hook Form 中 onChange 闭包问题的分析与解决

在 React Hook Form 7.53.0 版本中，开发者可能会遇到一个常见的闭包问题，特别是在处理表单选项变化时。本文将从技术角度深入分析这个问题，并提供多种解决方案。

问题现象

当使用 React Hook Form 的 register 方法注册单选按钮时，开发者可能会发现无论选择哪个选项，控制台总是打印最后一个选项的值。这是因为在注册 onChange 回调时，JavaScript 闭包捕获了循环中的最后一个值。

技术原理

这种现象本质上是一个经典的 JavaScript 闭包问题。在循环中注册事件处理器时，所有处理器都会共享同一个闭包作用域，最终都引用了循环结束时的最后一个变量值。

React Hook Form 的 register 方法内部实现会处理这种闭包问题，但在某些特定用法下，开发者仍可能遇到这种问题。

解决方案

1. 使用事件对象

最直接的解决方案是使用事件对象的 target.value 属性：

const { register } = useForm();
register('example', {
  onChange: (e) => console.log(e.target.value)
});

这种方法利用了浏览器原生事件对象，避免了闭包问题。

2. 使用独立注册

为每个选项单独注册，避免循环中的闭包问题：

const { register } = useForm();
const options = ['A', 'B', 'C', 'D'];

return (
  <>
    {options.map((option) => (
      <input
        key={option}
        type="radio"
        value={option}
        {...register('example', {
          onChange: () => console.log(option)
        })}
      />
    ))}
  </>
);

3. 使用自定义注册函数

创建一个自定义注册函数，为每个选项生成独立的闭包：

const { register } = useForm();

const registerOption = (value) => {
  return register('example', {
    onChange: () => console.log(value)
  });
};

return (
  <>
    <input type="radio" value="A" {...registerOption('A')} />
    <input type="radio" value="B" {...registerOption('B')} />
    {/* 其他选项 */}
  </>
);

最佳实践

1. 优先使用 React Hook Form 推荐的事件对象方式处理变化
2. 在循环中注册表单控件时，注意闭包问题
3. 考虑使用 Controller 组件处理复杂场景
4. 对于动态生成的表单元素，确保每个元素都有稳定的 key

总结

React Hook Form 作为流行的表单管理库，虽然内部已经处理了许多复杂场景，但开发者仍需理解 JavaScript 闭包机制。通过正确使用事件对象或采用适当的注册方式，可以避免这类问题，构建更健壮的表单逻辑。