UI 视觉设计 / 系统课时
定义表单校验时机与提交状态
定义表单校验时机与提交状态
同一张表单若在用户刚开始输入时就报错,容易造成干扰;若只在提交后报错,又会增加返工。本篇以“创建团队”表单为例,明确失焦、变更和提交时各检查什么,以及字段错误、异步失败和重复提交该如何反馈。
学习目标
- 为失焦、变更、提交三个阶段制定可执行的校验规则。
- 区分字段级错误与表单级错误的展示、清除和焦点处理。
- 定义提交中、成功、失败状态,并完成一组交互验收。
按字段是否被触碰决定校验时机
示例表单包含“团队名称”和“管理员邮箱”。团队名称必填,长度为 2~30 个字符;邮箱必填,需通过格式校验。首次聚焦时不显示错误,避免用户尚未完成输入就看到红字。
| 时机 | 触发条件 | 校验与反馈 |
|---|---|---|
变更 change |
字段尚未失焦且未尝试提交 | 更新输入值,不主动显示新错误 |
失焦 blur |
用户离开当前字段 | 标记为已触碰,检查必填、长度或格式;错误显示在该字段下方 |
再次变更 change |
字段已触碰,或表单曾提交失败 | 重新校验该字段;修正合格后立即清除对应错误 |
提交 submit |
用户点击“创建团队” | 校验全部字段;若有错误,不发送请求,聚焦第一个无效字段 |
若需要远程检查团队名称是否重复,可在已触碰字段修改后等待 400 ms 再发起查询,并忽略过期查询结果。远程检查只是提前提示;最终是否允许创建,仍以服务端提交校验为准。
区分字段错误与整个表单的失败
字段能明确归因时,错误放在对应控件下方。例如名称为“A”时显示“团队名称至少需要 2 个字符”;邮箱为 a@ 时显示“请输入有效的邮箱地址”。同一个问题不要再在顶部横幅重复展示。
服务端返回名称冲突(例如 HTTP 409)时,将“团队名称已存在,请更换”映射到名称字段。网络中断、超时或服务端不可用无法归因于某一字段,则在表单顶部显示“创建失败,请检查网络后重试”,保留所有已输入内容。
提交前端校验失败时,将页面滚动到第一个错误字段并把焦点移到该字段。实现时为无效输入设置 aria-invalid="true",用 aria-describedby 关联帮助文本或错误消息;全局异步结果可用 aria-live="polite" 宣告。再次修改对应字段后可以清除其错误,但不能顺带清除其他字段仍然存在的问题。
用状态转换阻止重复提交
提交动作按“校验通过才能发送请求”的守卫条件运行。表单状态与按钮反馈采用以下约定:
| 状态 | 按钮反馈 | 允许的下一步 |
|---|---|---|
editing |
“创建团队”,可点击 | 校验失败仍可编辑;通过则进入 submitting |
submitting |
“创建中…”,显示进度并禁用按钮 | 请求成功进入 success;失败进入 failed |
failed |
“重试创建”,恢复可点击 | 保留输入和错误提示;修改字段回到 editing,或直接重试 |
success |
“创建成功”,不再接受同次提交 | 显示结果或跳转到新团队页面 |

按钮禁用只阻止界面重复触发,无法单独防止网络重试造成重复创建。若创建操作可能被重复执行,服务端还需提供幂等键处理或业务唯一约束。提交期间若允许继续修改字段,必须用提交时的值版本识别并忽略过期响应,避免旧请求覆盖新输入。
按可重现的场景验收
以首次创建团队为例,逐项执行以下测试,不需要连接正式服务,可由测试环境模拟响应:
- 输入名称“A”后失焦:名称下方出现长度错误;改为“北极星设计组”后错误消失,未触碰的邮箱不提前报错。
- 邮箱留空并点击“创建团队”:显示邮箱必填错误,焦点进入邮箱,网络请求数为 0。
- 输入
team@example.com并提交:按钮变成“创建中…”且不能再次触发;连续点击两次,前端只发出 1 次创建请求。 - 模拟服务端返回名称冲突:名称下方出现“团队名称已存在”,输入内容保持不变,按钮恢复可操作;修改名称后可再次提交。
- 模拟网络断开或请求超时:顶部显示表单级错误,两个字段的值都保留;重试成功后显示成功反馈,同一次请求不能再次提交。
验收时还应只用键盘操作一次,并检查读屏软件能否读出焦点字段的错误。若失败后只出现红色边框、没有文字和可达焦点,说明错误反馈尚未达到交付要求。