React / 系统课时
处理提交状态
处理提交状态
本课补全表单提交期间的交互反馈:按钮在请求处理中禁用,成功和失败结果在页面中明确显示。完成后,用户不会因等待无提示而重复点击,也能区分校验失败与保存成功。
学习目标
- 使用
useFormStatus获取父表单的提交状态 - 在等待期间禁用提交按钮并更新文案
- 用操作返回状态展示成功和已知失败结果
四种基本状态
表单通常至少包含空闲、提交中、成功和失败四种状态。空闲时允许编辑;提交中时防止重复操作;成功后给出确认;失败后保留可修正输入。提交中是瞬时状态,成功和失败则来自服务端操作的返回值。
| 状态 | 页面行为 |
|---|---|
| 空闲 | 按钮可用,等待用户输入 |
| 提交中 | 按钮禁用,显示处理中 |
| 成功 | 显示确认信息 |
| 失败 | 显示可理解的错误信息 |
主示例:发送留言
useFormStatus 必须在表单内部的子组件中调用,它只跟踪最近的父级表单提交。官方说明见 React useFormStatus。
ts
// app/messages/actions.ts
'use server'
export type MessageState = {
status: 'idle' | 'success' | 'error'
message: string
}
export async function sendMessage(
_previousState: MessageState,
formData: FormData,
): Promise<MessageState> {
const content = String(formData.get('content') ?? '').trim()
if (content.length < 5) {
return {
status: 'error',
message: '留言至少需要 5 个字符',
}
}
// 仅用于观察 pending 状态,生产代码应删除人为延迟
await new Promise((resolve) => setTimeout(resolve, 1200))
console.log(`message saved: ${content}`)
return {
status: 'success',
message: '留言已发送',
}
}tsx
// app/messages/message-form.tsx
'use client'
import { useActionState } from 'react'
import { useFormStatus } from 'react-dom'
import {
sendMessage,
type MessageState,
} from './actions'
const initialMessageState: MessageState = {
status: 'idle',
message: '',
}
function SubmitButton() {
const { pending } = useFormStatus()
return (
<button type="submit" disabled={pending} aria-disabled={pending}>
{pending ? '发送中…' : '发送留言'}
</button>
)
}
export function MessageForm() {
const [state, formAction] = useActionState(
sendMessage,
initialMessageState,
)
return (
<form action={formAction}>
<label htmlFor="content">留言</label>
<textarea id="content" name="content" rows={4} />
<SubmitButton />
{state.message && (
<p role={state.status === 'error' ? 'alert' : 'status'}>
{state.message}
</p>
)}
</form>
)
}
// app/messages/page.tsx
import { MessageForm } from './message-form'
export default function MessagesPage() {
return (
<main>
<h1>发送留言</h1>
<MessageForm />
</main>
)
}预期结果
text
提交“你好”时,页面显示“留言至少需要 5 个字符”。
提交“请联系我”时,按钮约 1.2 秒内显示“发送中…”且不可重复点击,
随后页面显示“留言已发送”,服务器终端输出:
message saved: 请联系我防止重复操作
禁用按钮能减少连续点击,但不能成为服务端的唯一防重机制。网络重试、多个标签页或脚本调用仍可能重复提交。支付、下单、发券等关键操作应使用请求唯一标识、数据库唯一约束或幂等记录保证同一业务命令只执行一次。
不要在等待期间禁用整个表单后立即清空输入,否则失败时用户无法修正。是否允许继续编辑取决于业务,但提交按钮应明确反映当前状态。
成功与失败的处理边界
已知失败,例如字段不合法、余额不足或记录已存在,应返回结构化状态并展示给用户。未知异常应抛出,让最近的错误边界记录和处理,不要把数据库错误详情返回页面。
成功状态也应描述下一步,例如“已保存”“等待审核”或“邮件已发送”。只显示“成功”可能无法说明业务是否已经最终完成。
按自己的节奏,确认真正理解。