React / 系统课时

错误提示与交互状态

错误提示与交互状态

表单不只是收集值,还要明确告诉用户“哪里错了、现在能不能提交、请求是否正在进行、最终有没有成功”。本节用一个完整注册表单把字段错误、提交禁用、加载、服务端失败和成功状态串成一条可验证的交互路径。

学习目标

  • 区分字段级校验错误与提交级请求状态。
  • 在提交期间禁用按钮,避免重复请求。
  • 用可访问的提示把错误、加载和成功状态反馈给用户。

把字段错误和提交状态分开

字段错误回答“输入哪里不合法”,提交状态回答“这次请求进行到哪一步”。两者如果塞进一个布尔值,很快就无法表示“字段已合法但请求失败”或“请求处理中应禁止重复提交”等情况。

表单错误与提交状态流转

实现时可以用一个 errors 对象保存字段错误,再用 status 保存 idle、submitting、success、error。这样每次状态变化都有明确含义。

完成一个可运行的交互闭环

下面示例可直接替换现有 React 项目的 src/App.jsx。示例用 Promise 模拟注册请求,不依赖后端;输入 taken@example.com 会触发服务端失败分支。

jsx
import { useState } from "react";

function fakeRegister(values) {
  return new Promise((resolve, reject) => {
    setTimeout(() => {
      if (values.email === "taken@example.com") {
        reject(new Error("该邮箱已被注册"));
        return;
      }
      resolve();
    }, 800);
  });
}

function validate(values) {
  const errors = {};

  if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(values.email)) {
    errors.email = "请输入有效邮箱";
  }
  if (values.password.length < 8) {
    errors.password = "密码至少 8 位";
  }

  return errors;
}

export default function App() {
  const [values, setValues] = useState({ email: "", password: "" });
  const [errors, setErrors] = useState({});
  const [status, setStatus] = useState("idle");
  const [serverError, setServerError] = useState("");

  function updateField(event) {
    const { name, value } = event.target;
    setValues(current => ({ ...current, [name]: value }));
    // 用户继续修改时,清除该字段的旧错误,避免提示滞后。
    setErrors(current => ({ ...current, [name]: "" }));
    setStatus("idle");
    setServerError("");
  }

  async function handleSubmit(event) {
    event.preventDefault();

    const nextErrors = validate(values);
    if (Object.keys(nextErrors).length > 0) {
      setErrors(nextErrors);
      return;
    }

    setStatus("submitting");
    setServerError("");

    try {
      await fakeRegister(values);
      setStatus("success");
    } catch (error) {
      setStatus("error");
      setServerError(error.message);
    }
  }

  const submitDisabled =
    status === "submitting" || !values.email || !values.password;

  return (
    <form onSubmit={handleSubmit} noValidate>
      <label>
        邮箱
        <input
          name="email"
          value={values.email}
          onChange={updateField}
          aria-invalid={Boolean(errors.email)}
          aria-describedby="email-error"
        />
      </label>
      <p id="email-error" role="alert">{errors.email}</p>

      <label>
        密码
        <input
          name="password"
          type="password"
          value={values.password}
          onChange={updateField}
          aria-invalid={Boolean(errors.password)}
          aria-describedby="password-error"
        />
      </label>
      <p id="password-error" role="alert">{errors.password}</p>

      <button disabled={submitDisabled}>
        {status === "submitting" ? "提交中…" : "注册"}
      </button>

      {status === "error" && <p role="alert">{serverError}</p>}
      {status === "success" && <p role="status">注册成功</p>}
    </form>
  );
}

预期结果

text
邮箱或密码为空时,“注册”按钮不可点击。
输入格式错误的邮箱或少于 8 位的密码并提交后,对应字段下方显示错误提示。
提交合法数据后,按钮变为“提交中…”并暂时禁用;约 800 ms 后显示“注册成功”。
邮箱使用 taken@example.com 时,加载结束后显示“该邮箱已被注册”,用户可修改后再次提交。

等待时间在真实接口中会随网络变化,不能依赖固定毫秒数判断请求是否完成。

让交互状态始终有出口

禁用提交按钮主要用于阻止明显无效输入和正在提交时的重复请求。不要在请求失败后继续禁用,否则用户无法重试;也不要只在按钮上显示加载文字而保留可点击状态,否则快速点击可能产生并发提交。

字段错误应尽量靠近对应输入框,并通过 aria-invalid 与 aria-describedby 建立关联。提交级错误放在表单范围内,用 role="alert" 让辅助技术及时感知;成功消息可以使用 role="status",避免把正常结果当作紧急错误播报。

一个可靠表单的关键不是“状态越多越好”,而是每个状态都有明确含义、可见反馈和下一步操作:字段错了能改,请求中不能重复提交,失败后能重试,成功后能确认结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

错误提示与交互状态

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

登录哪都通