SuperAPI AI 工具集

accessibility-patterns

通用与其它

查看项目

更新于 10-15 19:52

技能介绍

用途:为 Android 与 iOS 移动应用提供无障碍实现模式,帮助开发者让界面可被屏幕阅读器(TalkBack、VoiceOver)正确朗读与操作,并满足 WCAG 2.1 对比度要求。

主要能力:Android/Jetpack Compose 侧包含内容描述(contentDescription,装饰元素用 null)、semantics 修饰符(contentDescription、stateDescription、heading、liveRegion 的 Polite/Assertive)、最小触控目标(48dp,sizeIn 或外层 Box 扩大点击区)、语义合并与清除(clearAndSetSemantics)、角色(Role.Button、Role.Tab、Role.Switch)、toggleable 开关、traversalIndex 遍历顺序。iOS/SwiftUI 侧包含 accessibilityLabel 与 accessibilityHint、accessibilityElement(children: .combine/.ignore)、Dynamic Type(系统字体样式与 @ScaledMetric)、减弱动效(accessibilityReduceMotion)、VoiceOver 转子(accessibilityRotorEntry 与自定义 rotor)、自定义无障碍操作(accessibilityAction)。跨平台部分给出 WCAG 2.1 对比度阈值(正文 4.5:1、大文本 3.0:1、UI 组件 3.0:1,AAA 为 7.0:1/4.5:1)及示例配色比值、焦点管理(FocusRequester、@FocusState)、错误播报(liveRegion 与 AccessibilityNotification.Announcement)。

使用方式:按平台选用对应代码模式,在组件上添加语义属性;测试部分提供 Compose 测试断言(onNodeWithContentDescription、hasMinimumTouchTargetSize)与手动检查清单(开启 TalkBack/VoiceOver 逐屏滑动、验证可聚焦与播报、图片描述、48dp 触控、200% 字体缩放、最大显示尺寸、高对比度/粗体、不以颜色为唯一状态指示、焦点顺序与视觉顺序一致)。

适用场景:移动端 UI 开发与无障碍审查。

限制:资料未提供安装命令、依赖版本、收费或平台支持范围等信息;触控目标 iOS 侧给出 44pt,Android 侧为 48dp。