核心功能
这个Skill的核心就是提供一个系统化的读屏软件测试框架,让你像做饭看菜谱一样,一步步搞定复杂的a11y验证。它主要包含以下几个方面:
- 主流读屏软件全覆盖:详细介绍了VoiceOver (macOS/iOS)、NVDA (Windows)、JAWS (Windows) 等市场占有率最高的读屏软件的安装、配置和核心使用命令。
- 结构化测试流程:提供了从页面加载、导航、表单交互到动态内容更新的完整测试清单(Checklist),确保你不会遗漏任何一个关键测试点。
- 代码级问题修复方案:针对“按钮没有标签”、“动态内容不播报”等常见问题,直接给出“错误”与“正确”的HTML/JavaScript代码对比,抄作业都给你准备好了。
- ARIA实战指南:深入讲解
role='dialog'、aria-live、role='tablist'等高级ARIA技术的正确实现方式,帮你搞定那些复杂的动态Web应用。 - 移动端适配:同样包含了针对Android (TalkBack) 和iOS (VoiceOver) 的手势操作和测试要点,确保你的Web应用在移动端也同样无障碍。
适用平台
这绝对是让这个Skill封神的一点!它被设计为可以无缝集成到你日常使用的各种AI编程环境中。无论你用的是Cursor、GitHub Copilot,还是Claude Code、Gemini Code Assist,甚至是国内的文心快码、腾讯云CodeBuddy和华为云CodeArts,都可以把它当作一个“最强外挂”来使用。
想象一下,当你在Cursor里写一个复杂的弹窗组件时,可以直接@这个Skill,问它:“一个符合WAI-ARIA规范的Modal对话框应该怎么管理焦点?” 它会立刻给你返回标准的JavaScript代码示例。这种体验,比自己去Google搜半天零散的博客文章,效率高到起飞!🚀
实操代码示例
光说不练假把式。我们来看两个最常见的场景,看看这个Skill是怎么帮你解决问题的。
场景一:修复一个“哑巴”按钮和“失声”的错误提示
很多时候我们为了美观,用SVG图标做按钮,结果读屏软件直接“无视”了它。或者表单校验失败了,错误信息出来了,但读屏软件根本不读,用户一脸懵逼。
修复前(错误示例):
<!-- 问题1: 按钮没有可访问的名称 -->n<button><svg>...</svg></button>nn<!-- 问题2: 动态错误信息没有被播报 -->n<input type='email' />n<span class='error'>Invalid email</span>
修复后(Skill提供的正确方案):
<!-- 方案1: 使用aria-label为按钮提供名称 -->n<button aria-label='关闭对话框'><svg aria-hidden='true'>...</svg></button>nn<!-- 方案2: 使用aria-describedby和role='alert'关联并播报错误 -->n<input type='email' aria-invalid='true' aria-describedby='email-error' />n<span id='email-error' role='alert'>Invalid email</span>
看到没?简单几个ARIA属性,问题迎刃而解。这些知识点零散地分布在各个角落,而这个Skill帮你全部整理好了。
场景二:实现一个无障碍的模态对话框(Modal)
模态框的无障碍是老大难问题,核心在于焦点管理。正确的行为是:打开时焦点进入模态框,关闭前焦点被
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END







暂无评论内容