用途:该规则用于审查渲染后的 HTML、交互组件或设计系统模式,检查可见标签文字与元素可访问名称(accessible name)是否一致。当可见标签与可访问名称不匹配时,语音控制用户可能无法通过朗读可见名称来操作该元素。
主要能力:1. 对比按钮、链接等元素的可见文本与其 aria-label 或 aria-labelledby 属性,确认可见文本已包含在可访问名称中。2. 确保可见文本作为可访问名称的一部分。3. 保证屏幕阅读器读取内容与视觉所见内容之间的一致性,使语音转文字用户能按可见名称触发控件。
修复方式:更新 ARIA 属性,使可访问名称的开头包含与可见标签完全一致的文本字符串。
代码审查:审查影响该规则的渲染标记与交互状态,指出违反规则的具体元素、角色、标签、焦点行为或键盘交互,并说明如何借助浏览器无障碍工具或辅助技术验证修复效果。
完整实现细节、代码示例和框架相关指南见 references/rule.md。规则页面:https://frontendchecklist.io/rules/accessibility/label-content-name-mismatch
限制:资料未提供该规则的具体代码实现、支持框架列表、安装方式或测试命令,暂未提供。