SuperAPI AI 工具集

fixing-accessibility

前端与建站

查看项目

更新于 10-15 22:16

技能介绍

fixing-accessibility 是一套无障碍审查与修复规则集,用于在 UI 开发中检查并修复 HTML 可访问性问题。它的规则按优先级分组:可访问名称、键盘访问、焦点与对话框、工具边界为关键级;语义、表单与错误为高优先级;状态播报为中高;对比度与状态为中;媒体与动效为低到中。

主要能力包括:确保每个交互控件都有可访问名称,纯图标按钮使用 aria-label 或 aria-labelledby,输入、选择与文本域都有标签,链接文字有意义,装饰性图标加 aria-hidden;保证键盘可达、焦点可见、不使用大于 0 的 tabindex、Escape 可关闭对话框;模态框需捕获焦点、关闭后恢复焦点、打开时设置初始焦点;优先使用原生元素而非 role 拼凑;列表、标题层级、表格表头需正确;表单错误用 aria-describedby 关联,必填与无效状态需可播报;关键错误用 aria-live,加载状态用 aria-busy;文本与图标对比度需足够,禁用状态不能只靠颜色;图片需正确 alt 文本,尊重 prefers-reduced-motion;同时强调最小改动,不重构无关代码,不滥用 aria,不擅自迁移 UI 库。

用法为在对话中应用规则,或以 /fixing-accessibility <file> 审查文件并报告违规片段、原因与代码级修复建议。

适用场景:新增或修改按钮、链接、输入、菜单、对话框、标签页、下拉框;构建表单、校验、错误状态与辅助文本;实现键盘快捷键或自定义交互;处理焦点状态、焦点捕获与模态行为;渲染纯图标控件;添加仅悬停交互或隐藏内容。

限制:资料未提供安装命令、依赖、版本、收费、平台支持或效果数据。规则要求最小化改动,复杂组件建议使用成熟的无障碍基础组件,而非自定义行为。