用途
aria-text 规则用于在审查渲染后的 HTML、交互组件或设计系统模式时,检查并避免在 role="text" 元素内出现可聚焦的后代元素。它属于无障碍(accessibility)检查范畴,目标是防止屏幕阅读器用户无法访问容器内的交互内容。
主要能力
- 识别带有 role="text" 的元素,并验证其不包含按钮、链接、输入框等可聚焦元素。
- 防止无障碍“黑洞”:当容器使用 role="text" 时,屏幕阅读器会把内部所有内容视为单一文本字符串,交互元素因此被隐藏。
- 提供检查、修复与解释三个环节:检查违规元素;移除 role="text" 或移出交互元素;解释 role="text" 如何覆盖后代元素语义。
- 支持代码审查:审查渲染标记与交互状态,标记违反规则的具体元素、角色、标签、焦点行为或键盘交互,并说明如何用浏览器无障碍工具或辅助技术验证修复。
使用方式
该规则以检查清单条目的形式提供,可在审查渲染后的 HTML、交互组件或设计系统模式时逐项核对。规则页面为 https://frontendchecklist.io/rules/accessibility/aria-text,完整实现细节、代码示例与框架相关指导见 references/rule.md。
适用场景
- 前端代码审查与无障碍审计。
- 设计系统组件模式检查。
- 交互组件(如包含链接或按钮的文本容器)的语义验证。
限制
资料未提供该规则的具体自动化工具集成方式、支持的框架列表或检测脚本,相关实现细节需参考 references/rule.md。