SuperAPI AI 工具集

ryux-accessibility

设计与创作

查看项目

更新于 10-20 17:13

技能介绍

RYUX Accessibility 是一个面向 UI 构建与评审场景的无障碍检查技能,归入 RYUX Design Intelligence 体系,属于交付门禁(Delivery Gate)中的 ACCESSIBILITY 领域,等级定义参见 ryux-core。该技能主张无障碍是产品质量的一部分,而非事后增强。

用途与检查范围: 技能要求开发或评审界面时逐项核对以下内容。语义(Semantics):使用真实的标题、地标、列表、按钮、链接和标签。键盘(Keyboard):所有功能可到达、可操作,焦点顺序与视觉顺序一致。焦点(Focus):每个交互元素都有可见焦点指示,不得在没有可访问替代的情况下移除。对比度(Contrast):文字至少 4.5:1,大文字和组件边界至少 3:1。目标尺寸(Targets):至少 24×24px,触控场景优先 44×44px。名称(Names):仅图标的按钮和有意义的图片需要有可访问名称。表单(Forms):标签与字段关联,错误与字段关联并向辅助技术播报。颜色(Color):不得仅用颜色作为信号。动态效果(Motion):尊重系统的减少动态效果设置。ARIA:仅在原生语义无法表达时才使用。

具体规则: RX-A11Y-01(必需,硬门禁)可读对比度:文字对比度保持至少 4.5:1,大文字和组件边界至少 3:1;不要在白底上使用浅灰文字,也不要在浅色强调色上使用白字。检查方式为 audit_ui。 RX-A11Y-02(必需,硬门禁)可读文字与可达目标:移动端正文约 14 至 16px,触控目标至少 24×24px,优先 44×44px;不要缩小正文或让小目标挤在一起。检查方式为 audit_ui。 RX-A11Y-03(必需,硬门禁)键盘与可见焦点:操作可从键盘完成(绘图这类基于路径的输入除外),显示可见焦点指示,焦点顺序与视觉顺序一致;不要构建仅指针可用的操作,也不要在没有可访问替代的情况下移除焦点轮廓。检查方式为 review。 RX-A11Y-04(必需,硬门禁)语义结构、原生控件与名称:优先使用真实标题、地标、列表、按钮、链接和正确的输入类型,再考虑自定义元素,并为仅图标按钮和有意义的图片提供可访问名称或替代文本;不要用装饰性 div 构建结构或控件,不要交付无标签的图标按钮。检查方式为 review。 RX-A11Y-06(必需)不只靠颜色:当颜色承载含义(错误、状态、选中)时,配合文字或图标;不要仅用颜色表示错误或选中状态。检查方式为 review。 RX-A11Y-07(必需)错误播报并与字段关联:将错误消息与其字段关联并向辅助技术播报;不要只以红色边框显示错误,或显示未与字段关联的文字。检查方式为 review。 RX-A11Y-08(必需)尊重减少动态效果:当系统请求减少动态效果时,用淡入或直接切换替代大幅移动;不要忽略系统减少动态效果设置。检查方式为 review。

证据与合规说明: 标准是主要证据(WCAG 2.2 成功标准),参考屏幕展示满足这些标准的本地模式(search_screens)。若没有 ryux MCP,应说明证据仅来自设计与标准。无论加载哪些技能,硬门禁始终适用:不得编造数字、人物、紧迫性、业务规则或术语;不得将占位内容作为最终内容交付;不得缺失关键状态(详见 ryux-core)。技能还要求报告检查了哪些内容以及如何检查,并明确不得在未做审计的情况下声称完全合规。

适用场景与限制: 适用于任何界面的构建与评审阶段,作为交付前的无障碍门禁检查。限制在于:资料未提供安装命令、代码示例、支持的平台或工具集成细节;也未提供收费、价格信息,这些事实暂未提供。实际落地时需要配合 ryux-core 的等级定义,并按需使用 audit_ui 或人工 review 完成检查。