UI 视觉设计 / 系统课时
标注输入控件的标签与校验反馈
标注输入控件的标签与校验反馈
用户在工单表单中填写邮箱时,需要知道“填什么、为什么填、哪里填错、怎样改正”。本篇以“新建工单”的联系邮箱字段为例,规定标签、占位符、帮助文本、必填标记和校验反馈的层级、尺寸及触发时机,最终形成开发可逐项核对的字段规范。
学习目标
- 区分标签、占位符、帮助文本、必填标记和错误提示的用途。
- 标注输入控件的结构尺寸、交互状态与校验触发条件。
- 检查错误反馈是否能被键盘用户和辅助技术用户感知。
分清五类信息的职责
假设“联系邮箱”是必填字段,负责接收工单处理通知。设计稿中的每一类文字都有固定职责,不允许以占位符代替标签,也不应在错误出现后删除原有帮助文本。
| 元素 | 本例文案 | 放置与规则 |
|---|---|---|
| 标签 | 联系邮箱 * | 输入框上方,始终可见;表单开头注明“* 表示必填” |
| 占位符 | name@example.com | 输入框内部,只提供格式示例;用户输入后自然消失 |
| 帮助文本 | 用于接收工单进度通知 | 输入框下方,持续可见 |
| 必填错误 | 请输入联系邮箱 | 失焦或提交校验失败后显示 |
| 格式错误 | 请输入有效的邮箱地址,例如 name@example.com | 已有输入但格式无效时显示 |
标签要描述字段含义,例如“联系邮箱”,而不是仅写“请输入”;占位符也不能承载“请填写真实邮箱”等必须长期可见的规则。错误文案要指出具体修改动作,避免只显示“无效”“输入错误”或红色感叹号。
标定布局与状态外观
以单列表单为设计基线:桌面端字段最大宽度 420px;390px 移动视口内宽度随父容器伸缩,不设置固定 420px。以下是本项目建议值,不是浏览器或设计规范强制值。
| 项目 | 标注值 |
|---|---|
| 标签 | 14px 字号、20px 行高;距输入框 8px |
| 输入框 | 最小高度 44px;左右内边距 12px |
| 帮助文本 | 12px 字号、18px 行高;距输入框 4px |
| 错误反馈 | 14px 字号、20px 行高;距帮助文本 4px |
| 相邻字段 | 整个字段组之间间隔 24px |
阅读顺序固定为标签→输入框→帮助文本→错误反馈。错误信息在帮助文本之后另起一行,并可换行;不要用绝对定位覆盖下一字段。字段密集且需要避免跳动时,可为错误行预留至少 20px 高度,但需在所有同类字段上保持一致。

状态标注至少覆盖四种情形:默认态使用中性边框;聚焦态显示清晰的 2px 焦点轮廓;错误态保留焦点指示,并同时显示错误图标、文字及边框变化;禁用态应清楚表示不可编辑,不应只靠降低透明度表达。没有明确需求时不必为“输入正确”增加绿色对勾。
定义校验触发与文案
把“是否触碰过字段”和“是否提交过表单”写进交互说明,避免用户刚打开页面就看到满屏红字,也避免每输入一个字符便反复报警。
| 触发事件 | 联系邮箱字段的反馈 |
|---|---|
| 首次显示 | 不显示错误;标签、占位和帮助文本可见 |
| 第一次离焦 | 空值显示“请输入联系邮箱”;tom@ 显示格式错误 |
| 错误已出现后继续输入 | 重新校验当前值;改成 tom@example.com 后撤销错误,不移除帮助文本 |
| 点击“提交工单” | 校验所有必填项;阻止无效提交,将焦点移至首个错误字段 |
本例只检查“非空”和基本邮箱格式;是否允许特殊字符、国际化邮箱及更严格的业务规则,应由产品和开发共同确认,不能依据设计稿里的示例邮箱擅自限制域名。提交后的服务端错误必须显示服务端确认的具体原因,不要伪装成格式校验失败。
错误出现后可在下一次输入时实时更新;但首次输入前不要立即展示“格式错误”。在设计交付说明里明确:错误文字随状态变化,字段输入值不丢失,用户可直接在原位置修正。
兼顾键盘和辅助技术
错误不能只靠红边框、颜色变化或图标传达;至少保留“错误图标+可理解的文字”,并将文字放在对应输入框附近。示例文案“请输入有效的邮箱地址”比“格式错误”更容易执行,前者还可附格式示例。
交付开发时同步标注语义关联:可见标签对应输入框的 label;必填状态由原生 required 或等效语义暴露;帮助与错误文本通过 aria-describedby 与字段关联;校验失败才设置 aria-invalid="true"。这些是实现约定,不意味着要把属性名画进面向用户的页面。
本例的普通说明与错误文本按至少 4.5:1 对比度检查;关键输入边框与焦点轮廓按至少 3:1 的相邻颜色对比检查。用 Tab 进入字段时,聚焦状态应清楚可见;错误提示出现后,不能仅靠鼠标悬停才能读取。
用工单表单验收规范
完成设计稿后至少提供默认、聚焦、错误、禁用四种状态,并给开发一份可重复的验证路径:
- 在 390px 视口打开表单,确认标签不消失、长错误文案能换行,页面无横向滚动。
- 键盘 Tab 定位到“联系邮箱”,检查焦点轮廓可见,帮助文本仍然保留。
- 输入
tom@后离焦,检查格式错误出现,图标、文字和边框状态一致。 - 改为
tom@example.com,确认错误消失但原输入值与帮助文字仍在。 - 清空字段并提交,检查“请输入联系邮箱”出现,焦点回到首个错误字段,其他已填字段内容不丢失。
交付标注必须同时包含文案、尺寸、状态切换时机和错误消失条件。只给静态红框而没有触发规则,开发无法判断何时显示或撤销提示。