用途
aria-required-attr 是前端检查清单(front-end-checklist)中的一条无障碍(accessibility)规则,适用于审查渲染后的 HTML、交互组件或设计系统模式。其核心目标是:确保带有特定 ARIA 角色的元素包含该角色所必需的 ARIA 属性。
根据规则说明,某些 ARIA 角色若缺少其必需属性,就会变得不完整,从而导致辅助技术无法正确传达元素的状态或值。
主要能力
该规则提供以下检查与修复能力:
- 识别需要特定状态或属性属性的角色。
- 确保诸如滑块(slider)所需的 aria-valuenow 等属性存在。
- 验证所有必需的 ARIA 属性是否已正确实现。
- 检查(Check):验证所有 ARIA 角色是否具备 WAI-ARIA 规范所定义的强制属性。
- 修复(Fix):为具有特定角色的元素补充缺失的必需 ARIA 属性(例如为 role="slider" 添加 aria-valuenow)。
- 解释(Explain):说明必需的 ARIA 属性如何提供屏幕阅读器正常运行所需的关键状态信息。
使用方式
该规则以代码审查(Code Review)的形式应用:审查渲染后的标记以及影响“为角色包含必需 ARIA 属性”这一规则的交互状态。审查时应指出违反规则的具体元素、角色、标签、焦点行为或键盘交互,并说明如何通过浏览器无障碍工具或辅助技术验证修复效果。
完整的实现细节、代码示例和针对特定框架的指导,参见 references/rule.md。
规则页面:https://frontendchecklist.io/rules/accessibility/aria-required-attr
适用场景
- 审查渲染后的 HTML 时。
- 审查交互组件时。
- 审查与“为角色包含必需 ARIA 属性”相关的设计系统模式时。
限制
资料未提供该规则的具体实现代码、框架适配细节、收费或价格信息、平台支持范围及效果保证,相关内容暂未提供。