React / 系统课时
处理多字段表单
处理多字段表单
字段增多后,为每个输入分别编写 state 和处理函数会迅速重复。本课把表单值收拢为一个对象,并通过字段 name、计算属性名和字段类型判断统一处理文本、选择和复选框。
学习目标
- 使用对象保存结构化表单状态
- 用统一函数更新不同字段
- 避免覆盖未修改的字段
让字段名对应状态键
统一处理函数依赖一个简单约定:每个控件的 name 与表单对象中的键一致。文本框和选择框读取 value,复选框读取 checked。更新对象时必须保留原字段,只替换当前键。
完整示例
jsx
import { useState } from 'react';
const initialForm = {
username: '',
department: 'engineering',
receiveNews: false,
};
export default function App() {
const [form, setForm] = useState(initialForm);
function handleChange(event) {
const { name, type, value, checked } = event.target;
const nextValue = type === 'checkbox' ? checked : value;
setForm((current) => ({
...current,
[name]: nextValue,
}));
}
function handleReset() {
setForm(initialForm);
}
return (
<main>
<label>
用户名
<input
name="username"
value={form.username}
onChange={handleChange}
/>
</label>
<label>
部门
<select
name="department"
value={form.department}
onChange={handleChange}
>
<option value="engineering">研发</option>
<option value="product">产品</option>
<option value="operations">运营</option>
</select>
</label>
<label>
<input
name="receiveNews"
type="checkbox"
checked={form.receiveNews}
onChange={handleChange}
/>
接收更新通知
</label>
<button type="button" onClick={handleReset}>重置</button>
<pre>{JSON.stringify(form, null, 2)}</pre>
</main>
);
}预期结果:
json
{
"username": "Ada",
"department": "product",
"receiveNews": true
}实际结果会随输入变化;点击“重置”后恢复为 initialForm。
更新对象时保留其他字段
setForm({ [name]: nextValue }) 会把整个对象替换成只含一个字段的新对象。正确做法是使用函数式更新,先展开当前对象,再覆盖本次变化的键。函数式写法还能确保连续更新基于最新状态。
表单对象应保持扁平且语义清楚。若存在地址、联系人等嵌套结构,可以为嵌套区域单独编写更新函数,或按功能拆成子组件;不要让一个通用处理函数承担复杂路径解析。
字段类型的边界
复选框使用布尔值 checked,单选按钮通常使用字符串 value,数字输入默认仍返回字符串。提交前再根据业务规则转换类型,比输入过程中强制转换更容易处理空值和暂存状态。
文件输入不能通过普通字符串 value 控制,通常交给浏览器维护,并在提交时读取文件对象。这类字段更接近非受控方案。
按自己的节奏,确认真正理解。