用途:fixing-accessibility 用于修复 UI 组件中的无障碍问题,适用于新增或修改按钮、链接、输入框、菜单、对话框、标签页、下拉框、表单、校验与错误状态,以及键盘快捷键、自定义交互、焦点状态、焦点陷阱、模态行为、纯图标控件、仅悬停交互或隐藏内容等场景。
主要能力:按优先级列出规则类别,包括可访问名称(critical)、键盘访问(critical)、焦点与对话框(critical)、语义(high)、表单与错误(high)、播报(medium-high)、对比度与状态(medium)、媒体与动效(low-medium)、工具边界(critical)。规则要求每个交互控件有可访问名称,纯图标按钮使用 aria-label 或 aria-labelledby,输入控件需有标签,链接文本有意义,装饰性图标 aria-hidden;交互元素可 Tab 到达、焦点可见、不使用大于 0 的 tabindex、Escape 关闭对话框;模态需陷阱焦点、关闭后恢复焦点、设置初始焦点;优先原生元素而非 role 技巧;错误用 aria-describedby 关联字段、必填与无效状态需播报;关键错误用 aria-live、加载用 aria-busy、可展开控件用 aria-expanded 与 aria-controls;保证对比度、悬停交互有键盘等价、禁用状态不只靠颜色;图片 alt 正确、视频字幕、尊重 prefers-reduced-motion、避免自动播放带声音媒体;偏好最小改动,不重构无关代码,原生语义可解决时不加 aria,不擅自迁移 UI 库。
使用方式:在对话中输入 /fixing-accessibility 可将约束应用到本次对话中的任何 UI 工作;输入 /fixing-accessibility <file> 可针对文件按全部规则审查并报告违规(引用确切行或片段)、原因(一句短说明)和具体修复(代码级建议)。不要重写大段 UI,优先最小、针对性修复。
限制:资料未提供安装命令、平台支持、收费或价格信息;复杂控件(菜单、对话框、组合框)建议优先使用成熟的无障碍原语而非自定义行为。