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",避免把正常结果当作紧急错误播报。
一个可靠表单的关键不是“状态越多越好”,而是每个状态都有明确含义、可见反馈和下一步操作:字段错了能改,请求中不能重复提交,失败后能重试,成功后能确认结果。
按自己的节奏,确认真正理解。