SuperAPI AI 工具集

accessibility

编程与开发

查看项目

更新于 10-16 09:31

技能介绍

用途:为 macOS 与 iOS 的 SwiftUI 应用提供可直接落地的无障碍实现模式,覆盖 VoiceOver、动态字体(Dynamic Type)、减弱动效(Reduce Motion)、减弱透明度、键盘导航与色彩对比。

主要能力:

  1. 自适应玻璃效果:通过 @Environment(.accessibilityReduceTransparency) 在开启减弱透明度时回退为纯色背景,并提供 adaptiveGlass 修饰器。
  2. 动效安全:提供 MotionSafeAnimation 修饰器与条件式 withAnimation,在 accessibilityReduceMotion 开启时跳过动画。
  3. VoiceOver:用 accessibilityElement(children: .combine)、accessibilityLabel、accessibilityHint、accessibilityAddTraits 组织标签;用 accessibilityActions 暴露复制、编辑、删除等自定义操作;用 accessibilityRotor 支持按收藏或分类导航;复制等不可见状态变化通过 UIAccessibility.post 或 NSAccessibility.post 播报。
  4. 动态字体:使用 @ScaledMetric 缩放图标与间距,并根据 dynamicTypeSize 在无障碍字号下减少网格列数,避免截断。
  5. 键盘导航(macOS):用 FocusState 与 onKeyPress 管理上下方向键、回车选择,并通过 Commands 注册快捷键。
  6. 色彩与对比:用 colorSchemeContrast 适配高对比模式,用 accessibilityDifferentiateWithoutColor 在状态指示器中同时给出图标与文字,不单独依赖颜色。
  7. 运行时设置检测:提供 AccessibilitySettings 观察对象,读取并监听减弱透明度、减弱动效、区分颜色与 VoiceOver 运行状态。

必要用法:将上述 ViewModifier 与扩展方法加入项目,在对应视图上使用 adaptiveGlass、motionSafeAnimation 等修饰器;交互元素补充无障碍标签与操作。

限制:资料未提供安装步骤、依赖要求、价格、平台版本限制或效果承诺,相关内容暂未提供;示例代码中的 Prompt、Category 等为演示类型。