用途:该技能用于审查并修复HTML无障碍问题,覆盖ARIA标签、键盘导航、焦点管理、颜色对比度和表单错误等。适用于在新增或修改按钮、链接、输入框、菜单、对话框、选项卡、下拉框等UI时参考;也适用于构建表单与校验、实现键盘快捷键或自定义交互、处理焦点状态或模态行为、渲染纯图标控件以及添加仅悬停交互等场景。\n\n用法:在对话中使用 /fixing-accessibility 应用规则约束当前UI工作;使用 /fixing-accessibility <file> 针对文件对照规则报告违规行、影响原因和代码级具体修复建议。工具边界要求偏好最小、定向的修复,不重写大段UI,不重构无关代码。\n\n主要规则按优先级:关键级包括可访问名称(交互控件须有名称,纯图标按钮用 aria-label 或 aria-labelledby,输入须有标签,链接文本须有意义,装饰图标设 aria-hidden)、键盘访问(不用 div 或 span 模拟按钮,Tab可达、焦点可见、tabindex 不超过0、Escape关闭对话框)、焦点与对话框(模态捕获焦点、关闭后恢复焦点、初始焦点在对话框内、打开不异常滚动);高优先级包括语义(优选原生元素,使用角色须带所需ARIA属性,列表用 ul/ol 加 li,标题不跳级,表格用 th)、表单与错误(错误用 aria-describedby 关联,必填可被播报,无效字段设 aria-invalid,辅助文本关联输入,禁用提交需说明原因);中等及以上包括播报(关键错误用 aria-live,加载用 aria-busy 或状态文本,toast 不得作为唯一信息渠道,可展开控件用 aria-expanded 与 aria-controls)、对比与状态(文本与图标对比度充足,仅悬停交互须有键盘等价,禁用态不单靠颜色,不无替代地移除焦点轮廓)、媒体与动效(图片正确 alt,含语音视频提供字幕,尊重 prefers-reduced-motion,避免自动播放带声媒体)。\n\n审查建议:先修关键问题(名称、键盘、焦点、工具边界),优先原生HTML而非添加aria,引用确切片段、说明失败原因并提出小修复,复杂组件优先使用成熟可访问基础组件。限制:资料未提供安装命令、收费或平台信息,暂未提供。
fixing-accessibility
前端与建站
更新于 10-16 02:39