UI 视觉设计 / 系统课时
定义文本输入框的标签和提示
定义文本输入框的标签和提示
以“团队名称”输入框为样例,给出标签、必填标记、辅助文案、字符计数和错误反馈的统一规格。设计交付时只需替换字段文案与校验条件,就能覆盖常态、聚焦、禁用及校验失败四种状态,避免占位符代替标签、输入中途频繁报错等问题。
学习目标
- 确定标签、输入区、辅助文案和计数器的固定位置与文案职责。
- 规定四种状态的视觉差异和错误出现、消失的时机。
- 用可复核的字段样例验收必填、长度限制和无障碍提示。
固定信息层级与排版
以宽 320px 的单行输入框为基准,标签始终放在输入区上方;无论是否已输入内容,都不能只靠占位文字标识字段。标签写“团队名称(必填)”,不要只放一个红色星号;选填字段则写“备注(选填)”,使规则不依赖颜色识别。
| 元素 | 建议规格 | 文案职责 |
|---|---|---|
| 标签 | 字号 14px、行高 20px;距输入区 8px | 说明用户要填什么 |
| 输入区 | 高 40px;内边距左右 12px | 承载值;占位符仅作示例 |
| 下方信息行 | 距输入区 6px;字号 12px、行高 18px | 左侧辅助说明或错误,右侧字符计数 |
| 字段间距 | 相邻字段至少 16px | 避免下方提示被误认为下一字段 |
占位符可写“例如:增长设计组”,但不得重复标签或承担唯一的格式规则。辅助文案写“用于工作台展示,2–20 个字符”;发生错误时,在同一左侧位置替换为具体纠正建议。右侧计数始终单独对齐,不与错误信息争夺一行宽度;窄屏允许计数换到下一行,但阅读顺序仍应为标签、输入、提示、计数。

区分常态、聚焦、禁用与错误
| 状态 | 外观和行为 | 下方信息 |
|---|---|---|
| 常态 | 1px 中性边框;标签始终可见 | 辅助文案与 0/20 |
| 聚焦 | 2px 蓝色焦点边框;保留输入光标 | 继续显示辅助文案与实时计数 |
| 禁用 | 浅灰底、弱化边框;不能获得焦点或编辑 | 保留必要说明,如“仅管理员可修改”;不显示编辑计数 |
| 校验失败 | 红色边框,错误文字与错误图标同步出现 | 用“至少输入 2 个字符”等消息替换辅助文案;计数保留 |
焦点和错误可能同时存在:此时保留可辨识的焦点外轮廓,错误仍用红色边框和文字说明,不要因错误态而移除键盘焦点标识。常态边框、焦点提示和错误提示需有足够对比度;正文小字以 4.5:1 为目标,重要控件边界及焦点图形以 3:1 为目标。禁用控件虽有对比度豁免,也应保证字段含义可辨。
决定错误出现与恢复的时机
输入初次获得焦点时不立即显示“必填”错误。以“团队名称”为例,采用以下交互规则:
- 未操作:显示默认说明,不标红,即使值为空。
- 首次输入中:只更新计数;未达到 2 字时不逐键弹出文字错误。
- 失焦:若内容为空、少于 2 字或超过 20 字,显示对应错误。
- 提交:校验所有启用字段;有错误则阻止提交,并把焦点移至第一个错误字段。
- 修正后:已报错的字段一旦重新满足规则,即撤销错误并恢复辅助文案;不必强迫用户再次失焦。
若用户直接提交空值,提示“请输入团队名称”;输入“A”后失焦,提示“至少输入 2 个字符”;超过上限则提示“最多输入 20 个字符”。不要仅提示“格式错误”,也不要在禁用字段上触发必填校验。服务端返回的业务校验错误可沿用同一错误槽位,但文案必须说明实际原因。
定义字符计数与边界规则
本样例允许 2–20 个用户可见字符,计数采用用户感知的字符单位:普通汉字和拉丁字母各计 1,组合表情按一个完整可见字符计 1。前后空格在失焦时清除,计数随展示值同步更新;设计与开发验收时必须使用同一口径。
| 输入场景 | 计数 | 展示行为 |
|---|---|---|
| 空输入 | 0/20 |
未触碰时不报错,失焦时报必填 |
设计组 |
3/20 |
合法,保留辅助文案 |
A |
1/20 |
首次失焦后显示最少字数错误 |
| 输入 21 个汉字 | 21/20 |
计数警示;失焦或提交时显示超限错误 |
此处采用软上限:允许用户暂时输入第 21 个字符以便修改,不自动截断粘贴内容。计数越界可立即改变视觉提示,但错误文字仍遵循首次失焦或提交的规则。若产品决定使用硬上限,则必须同步修改规格,不应再展示无法实际出现的 21/20 状态。
交付与验收检查
交付 Figma 组件时,将标签、必填标记、占位符、辅助文案、错误文案和计数定义为可替换内容,并分别保存四种状态。验收同一个 320px 示例以及窄屏宽度 240px:长错误文案可以换行,但不能压住计数或覆盖下一字段。
- 标签在有值、聚焦、出错后仍可见;占位符不充当标签。
- 必填不只靠红色星号;错误不只靠边框颜色。
- 实现时让可访问标签关联输入控件,辅助或错误消息通过描述关系关联;校验失败状态可由
aria-invalid传达。 - 键盘可聚焦字段有清晰焦点指示;禁用字段不参与提交校验。
- 用空值、1 字、20 字和 21 字四组数据逐项验收计数与报错时机。
验收通过的标准不是四张状态图外观相似,而是相同的字段在不同输入路径下给出一致的文案、计数和可访问反馈。