用途:审查 UI 代码中的音频反馈最佳实践与无障碍性,用于评审声音实现、检查音频 UX 决策或进行无障碍审计。
工作方式:读取指定文件(或让用户提供文件/匹配模式),按规则检查,以 file:line 格式输出发现的问题。
规则分为四类优先级:无障碍(a11y-)、适当性(appropriate-)、实现(impl-)、权重匹配(weight-)。
无障碍规则要求:每个音频提示必须有视觉等价物,声音不能替代视觉反馈(a11y-visual-equivalent);设置中提供显式关闭声音的开关(a11y-toggle-setting);将 prefers-reduced-motion 作为声音敏感度的代理并予以尊重(a11y-reduced-motion-check);允许独立于系统音量调节音量(a11y-volume-control)。
适当性规则要求:不要为高频交互(输入、键盘导航)添加声音;声音适合确认类操作(支付、上传、表单提交)以及不可忽视的错误与警告;不要为无信息价值的装饰性时刻添加声音;声音应当告知而非惩罚,避免对用户错误使用刺耳音效。
实现规则要求:预加载音频文件避免播放延迟;默认音量应轻微而非过响;重放前重置 currentTime 以支持快速触发。
权重匹配要求:声音权重与动作重要性匹配;声音时长与动作时长匹配。
输出格式为 file:line - [rule-id] 问题描述,随后给出规则、数量、严重度的汇总表,以及交互与是否配声音的声音适当性矩阵。参考资料包括 Web Audio API 文档与 prefers-reduced-motion。
限制:资料未提供安装命令、具体平台支持范围、版本或收费信息。