SuperAPI AI 工具集

axiom-accessibility-diag

通用与其它

查看项目

更新于 10-15 20:11

技能介绍

用途:为 iOS/macOS 应用提供系统化的无障碍诊断与修复方法,覆盖 VoiceOver 导航(缺失标签、元素顺序错误)、Dynamic Type 文字缩放、颜色对比度(WCAG AA/AAA)、触控目标尺寸(不低于 44x44pt)、iPadOS/macOS 键盘导航、Reduce Motion 支持,以及 App Store 审核无障碍要求与用户投诉响应。

主要能力:围绕 7 类关键问题给出常见违规写法与正确写法对照,包括:为控件补充描述性 accessibilityLabel 与必需的 accessibilityHint、用 accessibilityHidden 隐藏装饰元素、用 accessibilityElement(children:.combine) 合并元素;使用语义字体(如 .body/.headline)或 .system(size:).relativeTo() 支持 Dynamic Type,并用灵活布局避免大字号截断;采用系统色(.primary/.secondary)与图标加文字区分状态,满足 4.5:1、3:1 等对比度阈值;控件不小于 44x44pt 并保持 8pt 以上间距;用 Button 或 focusable 加 onKeyPress 支持键盘与焦点管理;通过 UIAccessibility.isReduceMotionEnabled 降级或移除动画;在 Info.plist 增加 UISupportsAssistiveAccess 并提供 AssistiveAccess 场景。

使用方式:按问题类型逐项排查,配合 VoiceOver(模拟器 Cmd+F5)、Xcode Preview 环境覆盖、Accessibility Inspector 的 Audit 页、Color Contrast Analyzer 等工具验证,并覆盖浅色/深色模式与增大对比度设置。

适用场景与限制:适用于准备上架或收到无障碍相关投诉的 iOS/macOS 应用。内容以 Swift/SwiftUI 与 UIKit 示例为主,未提供自动化脚本或命令行安装方式,具体项目集成需自行调整。