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 一致。

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

目录与阅读设置

阅读设置

17

记录一个想法

表单提交

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

登录哪都通