React / 系统课时

基础表单校验

基础表单校验

基础校验的目标是尽早发现可修正的问题,并阻止无效数据进入提交阶段。本课将校验必填、邮箱格式、密码长度和确认密码一致性,并把错误组织成与字段对应的对象。

学习目标

  • 编写可复用的同步校验函数
  • 实现单字段与跨字段规则
  • 仅在校验通过后执行提交

用纯函数描述规则

校验函数只接收表单值并返回错误对象,不直接修改 state,也不操作页面。纯函数容易单独测试,并能在提交、字段失焦或其他时机重复使用。

错误对象的键与字段名一致;没有错误的字段不写入对象。提交时可用 Object.keys(errors).length 判断是否通过。

完整校验示例

jsx
import { useState } from 'react';

function validate(form) {
  const errors = {};

  if (!form.email.trim()) {
    errors.email = '邮箱不能为空';
  } else if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(form.email)) {
    errors.email = '邮箱格式不正确';
  }

  if (form.password.length < 8) {
    errors.password = '密码至少需要 8 个字符';
  }

  if (form.confirmPassword !== form.password) {
    errors.confirmPassword = '两次输入的密码不一致';
  }

  return errors;
}

export default function App() {
  const [form, setForm] = useState({
    email: '',
    password: '',
    confirmPassword: '',
  });
  const [errors, setErrors] = useState({});
  const [result, setResult] = useState('');

  function handleChange(event) {
    const { name, value } = event.target;
    setForm((current) => ({ ...current, [name]: value }));
  }

  function handleSubmit(event) {
    event.preventDefault();
    const nextErrors = validate(form);
    setErrors(nextErrors);

    if (Object.keys(nextErrors).length > 0) {
      setResult('请先修正表单错误');
      return;
    }

    setResult('校验通过,可以提交');
  }

  return (
    <main>
      <form onSubmit={handleSubmit} noValidate>
        <label>
          邮箱
          <input name="email" value={form.email} onChange={handleChange} />
        </label>
        <p>{errors.email}</p>

        <label>
          密码
          <input
            name="password"
            type="password"
            value={form.password}
            onChange={handleChange}
          />
        </label>
        <p>{errors.password}</p>

        <label>
          确认密码
          <input
            name="confirmPassword"
            type="password"
            value={form.confirmPassword}
            onChange={handleChange}
          />
        </label>
        <p>{errors.confirmPassword}</p>

        <button>注册</button>
      </form>
      <p>{result}</p>
    </main>
  );
}

预期结果:

text
空邮箱、错误邮箱、短密码或两次密码不一致时,对应字段下方显示错误。
全部规则通过后显示“校验通过,可以提交”。

规则顺序与错误优先级

同一字段通常先判断必填,再判断格式或长度,否则空值可能同时得到多条错误。每个字段先展示最有行动价值的一条信息即可,避免一次性堆叠所有失败原因。

跨字段规则需要读取多个值,例如确认密码、结束时间晚于开始时间。它仍可放在同一个纯校验函数中,但错误应归属到最适合用户修正的字段。

客户端校验不是安全边界

前端校验改善交互,但请求可以绕过浏览器,因此服务端仍必须执行完整校验。服务端返回字段错误时,应把它们合并或映射到当前错误对象,而不是只显示模糊的“提交失败”。

正则表达式适合基础格式检查,不应尝试完整证明邮箱真实存在。真实性需要验证码、确认链接或服务端业务规则。

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

目录与阅读设置

阅读设置

17

记录一个想法

基础表单校验

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

登录哪都通