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
空邮箱、错误邮箱、短密码或两次密码不一致时,对应字段下方显示错误。
全部规则通过后显示“校验通过,可以提交”。规则顺序与错误优先级
同一字段通常先判断必填,再判断格式或长度,否则空值可能同时得到多条错误。每个字段先展示最有行动价值的一条信息即可,避免一次性堆叠所有失败原因。
跨字段规则需要读取多个值,例如确认密码、结束时间晚于开始时间。它仍可放在同一个纯校验函数中,但错误应归属到最适合用户修正的字段。
客户端校验不是安全边界
前端校验改善交互,但请求可以绕过浏览器,因此服务端仍必须执行完整校验。服务端返回字段错误时,应把它们合并或映射到当前错误对象,而不是只显示模糊的“提交失败”。
正则表达式适合基础格式检查,不应尝试完整证明邮箱真实存在。真实性需要验证码、确认链接或服务端业务规则。
按自己的节奏,确认真正理解。