SuperAPI AI 工具集

fixing-accessibility

前端与建站

查看项目

更新于 10-15 21:41

技能介绍

用途:审查并修复 HTML 无障碍问题,约束 UI 开发中的可访问性实现。适用于新增或修改按钮、链接、输入、菜单、对话框、标签页、下拉框,构建表单与校验/错误/辅助文本,实现键盘快捷键或自定义交互,处理焦点状态与焦点陷阱,渲染纯图标控件,以及添加仅悬停交互或隐藏内容。

主要能力与规则优先级:1 可访问名称(关键),2 键盘访问(关键),3 焦点与对话框(关键),4 语义(高),5 表单与错误(高),6 播报(中高),7 对比度与状态(中),8 媒体与动效(低中),9 工具边界(关键)。

必要用法:以斜杠命令 /fixing-accessibility 将约束应用于当前会话的 UI 工作;/fixing-accessibility <file> 按全部规则审查文件,报告违规(引用确切行或片段)、原因(一句)和代码级修复建议,不做大范围重写,优先最小化定点修复。'how to use' 中示例命令保持原样。

规则要点:交互控件须有可访问名称,纯图标按钮用 aria-label 或 aria-labelledby,输入项须有标签,装饰性图标 aria-hidden;不用 div/span 冒充按钮,可 Tab 到达,焦点可见,不用大于 0 的 tabindex,Escape 关闭对话框;模态需聚焦陷阱并在关闭后归还焦点;优先原生元素,列表用 ul/ol 与 li,不跳标题层级;错误用 aria-describedby 关联字段,必填须播报,无效字段设 aria-invalid;关键错误用 aria-live,加载用 aria-busy,可展开控件用 aria-expanded 与 aria-controls;对比度充足,悬停交互有键盘等价,不用颜色单独表示禁用状态,不无替代地移除焦点轮廓;图片 alt 正确,语音视频提供字幕,尊重 prefers-reduced-motion,避免自动播放声音。

限制:优先最小改动,不重构无关代码;原生语义已解决时不加 aria;未经要求不迁移 UI 库;复杂控件优先使用成熟的可访问基础组件。资料未提供平台、收费、安装命令或价格信息。