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 控制,通常交给浏览器维护,并在提交时读取文件对象。这类字段更接近非受控方案。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理多字段表单

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通