SuperAPI AI 工具集

button-name

前端与建站

查看项目

更新于 10-16 08:11

技能介绍

用途:这是一条前端可访问性检查规则,针对“为按钮提供可访问名称”。当按钮缺少可访问名称时,屏幕阅读器只会朗读为“button”,用户无法判断将触发什么操作。

主要要求:确保每个按钮都有可辨识、描述性的标签;可用按钮内部文本、aria-label 或 aria-labelledby 进行标识;按钮应只用于操作和状态变化,而不是页面导航;避免空按钮或仅包含非文字图标的按钮。

使用方式:先扫描缺少描述性文本或可访问标签的按钮;再通过文本内容、aria-label 或 aria-labelledby 引用为按钮添加可访问名称;如果该元素是跳转到另一 URL,则应改为链接而非保留按钮语义。在代码审查中检查渲染后的标记及交互状态,指出违反规则的具体元素、角色、标签、焦点行为或键盘交互,并说明如何用浏览器可访问性工具或辅助技术验证修复。

适用场景:前端代码审查、组件库与设计系统检查、可访问性测试与审计。

限制:资料未提供具体框架实现细节、完整代码示例和框架专属指南,仅指出可参见 references/rule.md;更完整的规则页面为 https://frontendchecklist.io/rules/accessibility/button-name。