Accessible Name
可访问名称
可访问名称是程序为控件或图片算出的标签。屏幕阅读器会用它识别项目。
另一个例子
屏幕阅读器用户移到只有图标的转账按钮。它的可访问名称是“转账 ¥2,400”,旁边的装饰图标没有名称。金额变化时,名称也会更新。
主要部分
- 01名称来源
- 02被引用文本
- 03计算结果
什么时候用
为每个控件和有意义的图片提供简短、清晰的名称。相邻项目的名称也要容易区分。
什么时候不要用
不要在 aria-label 中重复页面上的文字。也不要给装饰项目命名,以免屏幕阅读器播报多余或冲突的内容。
代码里的名称
label, alt, aria-labelledby, or aria-label in the accessible-name computation 上线前要检查
让辅助工具知道控件的名称(无障碍名称)、用途(角色)、值与状态。检查键盘操作、清楚可见的焦点、点击范围、禁用与忙碌状态、反馈及恢复。
预期结果:使用 可访问名称 (Accessible Name) 解决这项需求,同时保留用户当前的操作上下文。 用户场景:屏幕阅读器用户移到只有图标的转账按钮。它的可访问名称是“转账 ¥2,400”,旁边的装饰图标没有名称。金额变化时,名称也会更新。 建议界面模式:可访问名称 (Accessible Name)。 适用理由:为每个控件和有意义的图片提供简短、清晰的名称。相邻项目的名称也要容易区分。 不应使用的情况:不要在 aria-label 中重复页面上的文字。也不要给装饰项目命名,以免屏幕阅读器播报多余或冲突的内容。 产品要求:定义默认、加载、没有内容、错误、成功与恢复状态。保留用户已输入的内容,每个操作后都提供清楚反馈。 无障碍与韧性:使用结构正确的 HTML(语义化 HTML)和完整键盘操作。焦点要清楚可见,布局缩放后仍要好用。也要提供减少动态效果。遵守项目现有规则。除非项目已采用,否则不要新增界面组件库。 验收标准:主要任务可只用键盘完成,在 320px 宽度也能正常使用。焦点与状态变化可被辅助工具读出。加载、失败、重试、取消与减少动态效果都已验证。 证据与限制(证据边界):标准只涵盖列出的范围,不会替你决定外观、产品做法或 Vibulary 的教学示例。 待确认:产品文字、数据来源、分析事件、支持设备与语言,以及平台特有限制。
检查这份需求
请 AI 编程助手检查当前如何使用 可访问名称 (Accessible Name)。 定义:可访问名称是程序为控件或图片算出的标签。屏幕阅读器会用它识别项目。 生产环境检查:让辅助工具知道控件的名称(无障碍名称)、用途(角色)、值与状态。检查键盘操作、清楚可见的焦点、点击范围、禁用与忙碌状态、反馈及恢复。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。