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 “创建成功”,不再接受同次提交 显示结果或跳转到新团队页面

字段校验触发与提交状态的双轨交互图

按钮禁用只阻止界面重复触发,无法单独防止网络重试造成重复创建。若创建操作可能被重复执行,服务端还需提供幂等键处理或业务唯一约束。提交期间若允许继续修改字段,必须用提交时的值版本识别并忽略过期响应,避免旧请求覆盖新输入。

按可重现的场景验收

以首次创建团队为例,逐项执行以下测试,不需要连接正式服务,可由测试环境模拟响应:

  1. 输入名称“A”后失焦:名称下方出现长度错误;改为“北极星设计组”后错误消失,未触碰的邮箱不提前报错。
  2. 邮箱留空并点击“创建团队”:显示邮箱必填错误,焦点进入邮箱,网络请求数为 0。
  3. 输入 team@example.com 并提交:按钮变成“创建中…”且不能再次触发;连续点击两次,前端只发出 1 次创建请求。
  4. 模拟服务端返回名称冲突:名称下方出现“团队名称已存在”,输入内容保持不变,按钮恢复可操作;修改名称后可再次提交。
  5. 模拟网络断开或请求超时:顶部显示表单级错误,两个字段的值都保留;重试成功后显示成功反馈,同一次请求不能再次提交。

验收时还应只用键盘操作一次,并检查读屏软件能否读出焦点字段的错误。若失败后只出现红色边框、没有文字和可达焦点,说明错误反馈尚未达到交付要求。

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

目录与阅读设置

阅读设置

17

记录一个想法

定义表单校验时机与提交状态

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

登录哪都通