React / 系统课时

实现表单与数据修改

实现表单与数据修改

这一节把新增和编辑统一到一个 React 表单中:输入先在本地校验,通过后再提交异步保存,并用明确的成功或失败反馈收口。完成后,你会得到一条可复用的数据修改流程,而不是只会读取和展示数据。

学习目标

  • 使用受控表单统一处理新增与编辑状态。
  • 在提交前完成字段校验,并阻止无效请求。
  • 正确管理提交中、成功和失败反馈,避免重复提交。

把表单状态和业务状态分开

表单字段只描述“用户正在输入什么”,列表数据则描述“已经保存了什么”。把两者混在一起,编辑时很容易出现输入一半就直接改动列表的情况。更稳妥的做法是用 form 保存草稿,用 users 保存已提交数据,再用 editingId 判断当前是新增还是编辑。

一次完整修改通常会经过“输入 → 校验 → 提交中 → 成功或失败”几个阶段;编辑模式还需要先把已有数据填回表单。

新增与编辑表单的提交流程

用一个表单同时完成新增与编辑

下面示例可直接替换 Vite React 项目中的 src/App.jsx。saveUser 用延迟模拟接口,因此不依赖后端;真实项目只需要把它替换为 fetch 或请求库调用。

jsx
import { useState } from "react";

const initialUsers = [
  { id: 1, name: "Ada", email: "ada@example.com" },
  { id: 2, name: "Linus", email: "linus@example.com" },
];

let nextId = 3;

function saveUser(user) {
  return new Promise((resolve, reject) => {
    setTimeout(() => {
      // 输入 fail 用于演示接口失败;真实项目由网络或服务端决定结果。
      if (user.name === "fail") {
        reject(new Error("mock failure"));
        return;
      }
      resolve({ ...user, id: user.id ?? nextId++ });
    }, 500);
  });
}

function validate(form) {
  const errors = {};
  if (!form.name.trim()) errors.name = "姓名不能为空";
  if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(form.email)) {
    errors.email = "请输入有效邮箱";
  }
  return errors;
}

export default function App() {
  const [users, setUsers] = useState(initialUsers);
  const [form, setForm] = useState({ name: "", email: "" });
  const [editingId, setEditingId] = useState(null);
  const [errors, setErrors] = useState({});
  const [status, setStatus] = useState("idle");

  function startEdit(user) {
    setEditingId(user.id);
    setForm({ name: user.name, email: user.email });
    setErrors({});
    setStatus("idle");
  }

  function resetForm() {
    setEditingId(null);
    setForm({ name: "", email: "" });
    setErrors({});
  }

  async function handleSubmit(event) {
    event.preventDefault();
    const nextErrors = validate(form);
    setErrors(nextErrors);
    if (Object.keys(nextErrors).length > 0) return;

    setStatus("saving");
    try {
      const saved = await saveUser({ id: editingId, ...form });
      // 提交成功后再修改业务列表,避免把未保存草稿提前写入。
      setUsers((current) =>
        editingId
          ? current.map((user) => (user.id === editingId ? saved : user))
          : [...current, saved],
      );
      resetForm();
      setStatus("success");
    } catch {
      setStatus("error");
    }
  }

  return (
    <main>
      <h1>{editingId ? "编辑用户" : "新增用户"}</h1>
      <form onSubmit={handleSubmit}>
        <label>
          姓名
          <input
            value={form.name}
            onChange={(e) => setForm({ ...form, name: e.target.value })}
          />
        </label>
        {errors.name && <p>{errors.name}</p>}

        <label>
          邮箱
          <input
            value={form.email}
            onChange={(e) => setForm({ ...form, email: e.target.value })}
          />
        </label>
        {errors.email && <p>{errors.email}</p>}

        <button disabled={status === "saving"}>
          {status === "saving" ? "保存中..." : "保存"}
        </button>
        {editingId && <button type="button" onClick={resetForm}>取消</button>}
      </form>

      {status === "success" && <p>保存成功</p>}
      {status === "error" && <p>保存失败,请重试</p>}

      <ul>
        {users.map((user) => (
          <li key={user.id}>
            {user.name}({user.email})
            <button type="button" onClick={() => startEdit(user)}>编辑</button>
          </li>
        ))}
      </ul>
    </main>
  );
}

预期结果

text
首次打开显示 Ada 和 Linus 两条数据。
姓名为空或邮箱格式错误时,页面显示对应校验信息,不进入“保存中”。
填写合法数据并保存后,按钮短暂显示“保存中...”,随后列表新增一条 ID 为 <ID> 的用户并显示“保存成功”。
点击“编辑”后表单回填原值,保存后只更新对应用户,不新增重复记录。
姓名填写 fail 时模拟保存失败,页面显示“保存失败,请重试”,原输入仍保留。

<ID> 代表实际创建的记录标识,本示例从 3 开始递增;接入真实接口后由服务端返回。

处理提交边界

校验应发生在发请求之前,但后端仍必须再次校验,因为浏览器端规则可以被绕过。提交期间禁用主按钮能减少重复请求;如果接口本身可能被重复调用,还应在服务端配合幂等键或业务唯一约束。

失败时不要清空用户输入,否则用户修正网络问题后还要重新填写。成功后是否重置表单则取决于业务:新增通常重置,编辑通常退出编辑态。真正接接口时,只有服务端确认成功后才更新本地列表,或者采用明确设计过的乐观更新策略。

验收修改流程

可以按三个场景验证:提交空姓名应只出现校验错误;新增合法用户后列表应增加一项;编辑已有用户后列表长度应保持不变但内容更新。只要这三条成立,新增、编辑、校验、提交和反馈就形成了完整闭环。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现表单与数据修改

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

登录哪都通