SuperAPI AI 工具集

axiom-accessibility-diag

通用与其它

查看项目

更新于 10-16 00:22

技能介绍

用途:系统诊断并修复 iOS/macOS 应用的无障碍问题,重点覆盖最易导致 App Store 审核被拒与用户投诉的七类问题,帮助应用满足 VoiceOver、动态字体与颜色对比等要求。

主要能力: 一、VoiceOver 标签与提示。为按钮、图像提供可理解的标签,装饰性图像隐藏,多元素可合并为一个朗读单元,并说明何时需要提示。 二、动态字体。使用语义字体样式(如 .body、.headline)自动缩放;自定义字号可用 .system(size:).relativeTo() 或 UIFontMetrics.scaledFont 配合 adjustsFontForContentSizeCategory。 三、颜色对比。遵循 WCAG AA(普通文本 4.5:1、大文本 3:1)与 AAA(7:1、4.5:1),推荐使用随明暗模式自适应的系统颜色,并避免仅用颜色传达状态。 四、触控目标。可点击元素至少 44x44pt,目标之间保留 8pt 以上间距,可用 contentShape 扩大点击区域。 五、键盘导航。iPadOS/macOS 上使用 Button、focusable、focusSection、keyboardShortcut 与 FocusState 管理焦点。 六、减弱动态效果。通过 UIAccessibility.isReduceMotionEnabled 判断,提供瞬时或淡入淡出替代复杂动画、视差与自动播放。 七、常见违规。包括图片缺少标签、自定义控件缺少按钮特征、可调控件缺少可调节动作、状态变化未播报等。

使用方式:按文档中的正误代码对照修改 SwiftUI 或 UIKit 实现;用 Xcode 的 Accessibility Inspector(Open Developer Tool)指针检查标签、值、提示与特征,并运行 Audit 查看对比度、命中区域、截断文本、元素描述与特征问题;用模拟器 Cmd+F5 或设备三击侧键开启 VoiceOver,按清单验证导航顺序、双击激活、滑动调节、状态播报;通过环境变量 .environment(.sizeCategory, .accessibilityExtraExtraExtraLarge) 或系统设置测试动态字体。

适用场景:修复 VoiceOver 导航、动态字体违规、颜色对比不足、触控目标过小、键盘导航缺失、减弱动态效果支持,以及准备 App Store 审核的无障碍自查。

限制:资料未提供具体安装命令、依赖或版本要求;示例以 iOS/macOS 平台为主,其他平台是否适用暂未提供;部分测试需真机与系统设置配合。