用途:帮助开发者构建并审计 SwiftUI、UIKit、AppKit 界面,使其在 VoiceOver、切换控制、语音控制、全键盘访问及自适应辅助功能设置下仍可操作。
主要能力:讲解 VoiceOver 固定朗读顺序(标签→值→特征→提示);SwiftUI 无障碍修饰符;焦点管理,包括 @AccessibilityFocusState(iOS 15+)单目标与枚举多目标焦点、模态关闭后焦点返回触发元素、自定义弹层需 .isModal 特征与 .escape 动作;UIKit 的 UIAccessibility.post 通知(announcement、layoutChanged、screenChanged);动态字体与 @ScaledMetric;自定义转子;系统偏好(Reduce Motion、Reduce Transparency、Increase Contrast、Bold Text);装饰性内容处理;语音控制可朗读且唯一的标签与 accessibilityInputLabels;切换控制分组与自定义动作;全键盘访问审计;Assistive Access(iOS 18+);UIKit/AppKit 无障碍模式;accessibilityCustomContent;App Store 无障碍营养标签;XCTest 自动化测试;常见错误与审查清单。
使用方式:按文档章节查阅对应模式,参考 references/a11y-patterns.md 获取 SwiftUI、UIKit、AppKit 示例,营养标签问题参考 references/nutrition-labels.md。测试需在设置中开启 VoiceOver、语音控制、全键盘访问、切换控制等,并用 Accessibility Inspector 与 XCTest 辅助验证。
适用场景:iOS/macOS 应用无障碍开发、审计与 App Store 无障碍声明准备。
限制:键盘焦点机制(.focusable()、@FocusState、focusSection()、UIFocusGuide 等)应转交 focus-engine 技能;自动化测试不能替代人工辅助技术测试;App Store 无障碍声明须有证据支撑,不得当作营销宣传。具体平台版本与实现细节以官方资料为准。