文本框:无障碍
文本框允许用户在 UI 中输入文本
使用场景
用户应能够:
- 使用辅助技术导航至文本框并激活该字段
- 在文本框中输入信息
- 接收并理解辅助文本和错误消息
- 导航至交互式图标并选择它们
交互与样式
填充文本框和描边文本框的容器功能相同。描边颜色和粗细的变化可提供清晰的交互视觉提示。


容器可在文本框与周围内容之间形成对比,使文本框更易于被发现。
在某些情况下,当容器轮廓与背景的对比度达到 3:1 或更高时,描边文本框会更易于识别。


键盘导航
| 按键 | 操作 |
|---|---|
| Tab | 焦点移至未禁用的文本框上 |
元素标注
当 UI 文本正确关联后,辅助技术(如屏幕阅读器)会先读取 UI 文本,再读取组件角色。
文本框的无障碍标签与其标签相同。

对于带有交互式尾随图标的文本框,无障碍标签应说明图标的功能。
例如,当密码隐藏时,查看图标的标签为“显示密码”;当密码可见时,其标签为“隐藏密码”。
当图标没有可操作角色时(例如错误图标),其标签为“错误”。

文本框的前缀和后缀提供符号和缩写,帮助用户输入正确的值。
前缀和后缀的无障碍标签需要具有唯一的 id 属性。例如,货币符号前缀的 id 属性应使用对应的货币名称。

出现错误时,应将角色设为“alert(警报)”,并将错误消息作为文本标签。
如果文本框同时显示辅助文本和错误文本,无障碍标签应先包含辅助文本,再包含错误文本。

字符计数器的无障碍标签用于说明文本框中可输入的字符数。

辅助文本中显示的文本也会作为其无障碍标签内容。

如果文本框为必填项,请在文本框标签末尾添加星号。无障碍标签必须包含该星号。
