SuperAPI AI 工具集

swift-accessibility-skill

编程与开发

查看项目

更新于 10-15 23:34

技能介绍

该技能用于在 SwiftUI、UIKit 和 AppKit 中落地平台无障碍最佳实践,覆盖 App Store 无障碍营养标签的全部 9 个类别:旁白、语音控制、更大文字、深色界面、不依赖颜色区分、足够对比度、减弱动态效果、字幕与音频描述。它优先使用可获得自动支持的原生平台 API,并主张在初稿就内置无障碍,避免事后补丁。

主要能力:为仅图标按钮添加无障碍标签;标记装饰性图像为隐藏;用文字样式或 @ScaledMetric 替代固定字号;按减弱动态效果门控动画;用形状、图标或文字补充颜色所表达的状态;为自定义控件提供 accessibilityRepresentation 或可调节动作;用无障碍通知播报动态变化;保证触控目标不小于 44×44pt;在 AppKit 中为自定义 NSView 设置元素、角色与标签并管理模态焦点。推荐使用原生控件(Button、Toggle、Stepper、Slider、Picker、TextField;AppKit 的 NSButton、NSPopUpButton、NSSlider 等)以自动获得完整无障碍支持。

使用方式:先确定框架与平台,再按意图选择主参考文件;写代码时对 iOS 15 之后的新 API 加 #available 守卫并提供旧系统回退;推断的标签标注 [VERIFY] 供人工复核。可在用户明确要求时审计代码(快速修复模式仅处理阻断项,综合模式默认处理全部严重级别),并可生成无障碍营养标签建议与代码可验证项检查清单,使用 XCUITest 的 performAccessibilityAudit()(需 iOS 17+/macOS 14+ 守卫)配合旧系统回退断言。

适用场景:新增或修复 SwiftUI、UIKit、AppKit 界面代码,无障碍审计,营养标签申报准备,发布前设备测试。

限制:营养标签需完整流程覆盖;对照度须在浅色与深色模式分别测试;iOS 17+ API 缺少可用性守卫会在旧系统崩溃;具体测试与审计细节需查阅其参考文件。其余未在资料中提供的细节暂未提供。