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: 请联系我

防止重复操作

禁用按钮能减少连续点击,但不能成为服务端的唯一防重机制。网络重试、多个标签页或脚本调用仍可能重复提交。支付、下单、发券等关键操作应使用请求唯一标识、数据库唯一约束或幂等记录保证同一业务命令只执行一次。

不要在等待期间禁用整个表单后立即清空输入,否则失败时用户无法修正。是否允许继续编辑取决于业务,但提交按钮应明确反映当前状态。

成功与失败的处理边界

已知失败,例如字段不合法、余额不足或记录已存在,应返回结构化状态并展示给用户。未知异常应抛出,让最近的错误边界记录和处理,不要把数据库错误详情返回页面。

成功状态也应描述下一步,例如“已保存”“等待审核”或“邮件已发送”。只显示“成功”可能无法说明业务是否已经最终完成。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理提交状态

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

登录哪都通