表单管理 Hook
中等 约 40 分钟
你将构建什么
一个管理字段值、跟踪 touched/dirty 状态、运行验证器并为受控输入返回 props 的 useForm hook。
学习目标
- 在单个对象中管理表单字段状态
- 跟踪 touched 和 dirty 字段
- 运行验证器并收集错误
- 为受控输入生成 props
前置要求
- useState 和自定义 hooks
- React 中的受控输入
- 对象展开和计算键
步骤
- 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
实现 handleChange
handleChange 接受事件并用计算属性键更新 values[field]。对任何带 name 属性的输入有效。
代码const handleChange = (e) => { const { name, value } = e.target; setValues(prev => ({ ...prev, [name]: value })); };预期结果
在字段中输入更新 values[fieldName]。
- 3
添加验证
接受接受 values 并返回 errors 对象的 validate 函数。根据 UX 偏好在 change 或 blur 时运行。
提示
常见模式:在 blur(用户离开字段时)和 submit 时验证,而非每次按键。
- 4
实现 handleSubmit
handleSubmit 接受 onSubmit 回调,阻止默认、运行最终验证,仅无错误时调用 onSubmit。
提示
submit 时标记所有字段为 touched,使所有错误显示,即使用户从未访问的字段。
- 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> ); }预期结果
表单在无效输入时显示错误,有效提交时打印数据。
自己动手试试
起始代码
function useForm(initialValues, validate) {
// TODO: state, handlers, return
}解决方案代码
function useForm(v, val) { const [values, setV] = useState(v); const [errors, setE] = useState({}); const handleChange = (e) => setV(p => ({...p, [e.target.name]: e.target.value})); return { values, errors, handleChange }; }你学到了什么
你构建了表单管理 hook——react-hook-form 等库的核心。理解它有助于选择或构建合适的表单方案。
相关资源
相关课程
- React Hooks
自定义 hook 封装表单逻辑。
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。