用途
aria-progressbar-name 是一项前端无障碍检查规则,用于确认进度条元素是否被赋予了可访问名称。当进度条缺少可访问名称时,屏幕阅读器用户只能获知页面上存在一个进度条,却无法了解它所代表的任务或流程,从而丢失上下文信息。
主要要求
规则要求使用 aria-label 或 aria-labelledby 为进度条命名,并确保名称能够描述该进度所指示的具体内容。同时应避免在标签中出现类似 "progress" 的冗余文字。当进度数值已知时,需要提供 aria-valuenow、aria-valuemin 和 aria-valuemax。对于向用户传达状态的视觉进度计量,应使用真实的进度语义,而不是装饰性的 div。
使用方式
规则以检查、修复、解释和代码审查的形式组织。检查环节:确认所有进度条元素(role="progressbar")是否通过 aria-label 或 aria-labelledby 拥有可访问名称。修复环节:为进度条添加 aria-label 或 aria-labelledby 属性,说明它正在度量什么。解释环节:说明进度条为何需要可访问名称,以便屏幕阅读器用户理解加载状态的上下文。代码审查环节:审查已渲染的标记以及影响该规则的交互状态,指出违反规则的具体元素、角色、标签、焦点行为或键盘交互,并说明如何使用浏览器无障碍工具或辅助技术验证修复效果。
适用场景
适用于评审已渲染的 HTML、交互组件,以及与进度条可访问名称相关的设计系统模式。
限制
规则页面仅提供上述检查要点与操作方向。完整的实现细节、代码示例和框架专属指导需参见 references/rule.md,本次资料中暂未提供该文件的具体内容。其他具体实现细节暂未提供。