SuperAPI AI 工具集

aria-text

前端与建站

查看项目

更新于 10-16 05:30

技能介绍

用途

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。