Skip to content

表单管理 Hook

中等 约 40 分钟

你将构建什么

一个管理字段值、跟踪 touched/dirty 状态、运行验证器并为受控输入返回 props 的 useForm hook。

学习目标

  • 在单个对象中管理表单字段状态
  • 跟踪 touched 和 dirty 字段
  • 运行验证器并收集错误
  • 为受控输入生成 props

前置要求

  • useState 和自定义 hooks
  • React 中的受控输入
  • 对象展开和计算键

步骤

  1. 1

    设置 hook 状态

    创建 useForm(initialValues),持有 values、errors 和 touched 状态。返回 handleChange、handleBlur、handleSubmit 和当前状态。

    代码
    function useForm(initialValues) {
      const [values, setValues] = useState(initialValues);
      const [errors, setErrors] = useState({});
      const [touched, setTouched] = useState({});
      return { values, errors, touched };
    }

    预期结果

    hook 返回初始状态,errors 和 touched 为空。

  2. 2

    实现 handleChange

    handleChange 接受事件并用计算属性键更新 values[field]。对任何带 name 属性的输入有效。

    代码
    const handleChange = (e) => {
      const { name, value } = e.target;
      setValues(prev => ({ ...prev, [name]: value }));
    };

    预期结果

    在字段中输入更新 values[fieldName]。

  3. 3

    添加验证

    接受接受 values 并返回 errors 对象的 validate 函数。根据 UX 偏好在 change 或 blur 时运行。

  4. 4

    实现 handleSubmit

    handleSubmit 接受 onSubmit 回调,阻止默认、运行最终验证,仅无错误时调用 onSubmit。

  5. 5

    构建注册表单

    用 useForm 构建含 name、email 和 password 的注册表单。添加检查必填字段和邮箱格式的 validate 函数。

    代码
    function RegistrationForm() {
      const { values, errors, handleChange, handleSubmit } = useForm(
        { name: '', email: '', password: '' },
        (vals) => {
          const errs = {};
          if (!vals.name) errs.name = 'Required';
          if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(vals.email)) errs.email = 'Invalid email';
          if (vals.password.length < 8) errs.password = 'Too short';
          return errs;
        }
      );
      
      return (
        <form onSubmit={handleSubmit(data => console.log('Submitted:', data))}>
          <input name="name" value={values.name} onChange={handleChange} />
          {errors.name && <span>{errors.name}</span>}
          {/* email, password similarly */}
          <button type="submit">Register</button>
        </form>
      );
    }

    预期结果

    表单在无效输入时显示错误,有效提交时打印数据。

自己动手试试

你学到了什么

你构建了表单管理 hook——react-hook-form 等库的核心。理解它有助于选择或构建合适的表单方案。

相关资源

相关课程

查阅不认识的术语

新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。

查看术语表

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回主题