React / 系统课时
表单提交
表单提交
表单提交不仅是读取字段,还要阻止默认刷新、整理业务数据、调用保存逻辑并反馈结果。本课用一个可运行的异步示例串起完整提交过程,并避免重复提交。
学习目标
- 使用
onSubmit统一处理提交 - 整理并提交规范化数据
- 管理提交中、成功和失败状态
由 form 负责提交入口
应把提交逻辑绑定到 <form onSubmit>,这样点击按钮和按 Enter 都能走同一流程。处理函数首先调用 event.preventDefault(),阻止浏览器按传统表单方式刷新页面。
按钮在表单中默认可能是提交按钮。只负责重置、显示帮助等操作的按钮,应显式设置 type="button"。
完整异步提交示例
jsx
import { useState } from 'react';
function saveProfile(payload) {
return new Promise((resolve, reject) => {
setTimeout(() => {
if (payload.email.endsWith('@example.com')) {
resolve({ id: 'user-001' });
} else {
reject(new Error('仅接受 @example.com 邮箱'));
}
}, 600);
});
}
export default function App() {
const [form, setForm] = useState({ name: '', email: '' });
const [status, setStatus] = useState('idle');
const [message, setMessage] = useState('');
async function handleSubmit(event) {
event.preventDefault();
if (status === 'submitting') return;
const payload = {
name: form.name.trim(),
email: form.email.trim().toLowerCase(),
};
setStatus('submitting');
setMessage('');
try {
const result = await saveProfile(payload);
setStatus('success');
setMessage(`保存成功,用户 ID:${result.id}`);
} catch (error) {
setStatus('error');
setMessage(error.message);
}
}
return (
<main>
<form onSubmit={handleSubmit}>
<input
value={form.name}
onChange={(event) =>
setForm((current) => ({ ...current, name: event.target.value }))
}
placeholder="姓名"
/>
<input
value={form.email}
onChange={(event) =>
setForm((current) => ({ ...current, email: event.target.value }))
}
placeholder="邮箱"
/>
<button disabled={status === 'submitting'}>
{status === 'submitting' ? '提交中…' : '提交'}
</button>
</form>
<p aria-live="polite">{message}</p>
</main>
);
}预期结果:
text
输入以 @example.com 结尾的邮箱后提交,约 600 毫秒后显示保存成功。
输入其他邮箱时显示“仅接受 @example.com 邮箱”。
提交期间按钮被禁用,不能重复提交。提交数据与界面状态分离
表单 state 可以保留用户正在编辑的原始字符串,提交时再生成 payload,统一执行去空格、大小写转换和类型转换。这样不会在输入过程中擅自改变光标位置或用户内容。
status 表示流程阶段,message 表示要展示的结果。真实请求还应依据响应状态判断成功与失败,并在组件卸载、请求取消或重复请求时采用项目统一策略。
验收提交行为
至少验证三件事:按 Enter 与点击按钮结果一致;提交中不会重复发送;成功和失败都能恢复为可继续操作的界面。浏览器开发者工具中不应出现整页刷新,真实接口场景还应检查请求体是否与整理后的 payload 一致。
按自己的节奏,确认真正理解。