SuperAPI AI 工具集

ios-accessibility

通用与其它

查看项目

更新于 10-16 06:05

技能介绍

Apple Platform Accessibility

让核心内容与操作在受支持的辅助技术下可感知、可操作、可理解、可测试。

目录

范围与兼容性

审查流程

语义规则

布局与偏好

验证

常见错误

审查清单

参考

范围与兼容性

该技能负责语义标签/值/特征、分组与遍历、自定义操作、焦点、动态字体、对比度、动效/透明度偏好、语音控制、键盘访问以及无障碍验证。视觉布局实现应交给相关 UI 技能;当主要请求是提交就绪性时,App Store 声明政策应交给 app-store-review。

选择 API 之前,先检查部署目标、平台、UI 框架和受支持的设备类别。除非修复必须改变现有交互行为,否则应保留现有行为,并在 SDK 头文件或 Apple 一手文档中核对带版本的 API。

审查流程

识别屏幕的核心信息、主要操作、状态变化、错误以及时间敏感内容。

检查语义输出,而不是从视觉外观推断无障碍能力。

测试导航顺序、标签、值、特征、操作、焦点、文字缩放、对比度、减弱动态效果、降低透明度,以及适用的键盘/语音控制路径。

在保留普通交互的前提下,修复最窄的语义或布局边界。

重新运行自动化检查,并手动实际走查受影响的辅助技术路径。

阅读 Accessibility Patterns 获取 SwiftUI/UIKit/AppKit 配方、焦点管理、转子(rotors)与 XCTest 示例。

语义规则

优先使用原生控件,因为它们同时提供语义与交互行为。

为每个核心控件提供可理解的辅助功能名称;避免只重复控件类型的标签。

通过值或特征暴露变化的状态,而不仅依赖颜色或动画。

仅当合并后的元素仍可理解且可操作时,才合并子元素。

隐藏装饰性内容,但绝不隐藏理解状态或完成任务所需的信息。

当手势或上下文菜单否则难以被发现时,添加具名的辅助功能操作。

播报重要的异步结果,但不要让例行更新淹没用户。

保持焦点顺序与阅读和任务顺序一致;必要时在模态或破坏性转换后恢复焦点。

布局与偏好

支持无障碍文字尺寸,避免裁切核心内容或强制固定横向布局。让控件按需增大、换行或改变轴向。最小目标尺寸是可用性底线,不能替代间距与清晰标签。

当 UI 依赖这些通道时,尊重系统偏好,包括减弱动态效果、降低透明度、无需颜色区分、提高对比度、按钮形状。将动画替代方案交给 swiftui-animation,将普通容器构建交给 swiftui-layout-components,将跨尺寸裁切或重排修复交给 swiftui-responsive-layout。

媒体相关工作应阅读 Media Accessibility,了解字幕、音频描述与播放控件。

验证

自动化无障碍审查与基于标识符的 UI 测试能捕获回归,但不能证明可用性。应使用 VoiceOver 与相关输入方式手动测试核心任务。使用 Accessibility Inspector 检查元素层级、名称、值、操作与对比度。

不要仅凭实现就宣称支持 App Store 无障碍。阅读 Accessibility Nutrition Labels,收集测试证据,并将声明范围限定在实际验证过的平台与功能上。

常见错误

使用仅图标按钮而不提供显式的 .accessibilityLabel。

实现自定义点按或滑动手势,却没有等价的 .accessibilityAction。

硬编码固定高度或宽度,导致动态字体缩放时文字被截断。

仅通过颜色传达核心状态或校验结果,而没有文字或符号指示。

设置有误导性的辅助功能特征(例如把非交互视图标记为 .isButton)。

审查清单

核心控件具有清晰的标签、值、特征,并在需要时提供提示

含义不只通过颜色、形状、位置或动效传达

阅读与焦点顺序符合任务流程

自定义手势有无障碍替代方案

动态字体在无障碍尺寸下工作且不丢失核心内容

动效/透明度/对比度偏好有相应行为

错误与重要完成状态被适当暴露和播报

当在范围内时,测试键盘、语音控制、开关控制或全键盘访问路径

自动化审查通过,且主要流程经人工验证

商店声明有当前证据支撑

参考

实现、焦点、转子与测试模式

媒体无障碍

App Store Accessibility Nutrition Labels