SuperAPI AI 工具集

capacitor-accessibility

通用与其它

查看项目

更新于 10-15 17:31

技能介绍

用途:让 Capacitor 应用在 iOS 与 Android 上具备无障碍能力。Capacitor 界面是 WKWebView / Android WebView 中的网页内容,语义化 HTML 与 ARIA 承担大部分工作,本技能聚焦 WebView 与原生层区别于普通浏览器的部分。

适用场景:需要 VoiceOver/TalkBack 支持、无障碍审计、WCAG 2.2/EAA/ADA 合规;文字不随 iOS Larger Text 放大或大号安卓字体下布局错乱;屏幕阅读器不播报页面切换、Toast 或加载状态;原生视图(地图、相机预览、视频播放器)无法被屏幕阅读器访问;需要使用 @capacitor/screen-reader 或 @capacitor/text-zoom。

主要能力与要点:iOS Dynamic Type 默认被忽略,可用 CSS html { font: -apple-system-body; } 配合 rem/em,或用 @capacitor/text-zoom 的 TextZoom.getPreferred() 与 TextZoom.set({ value }),两者只能选其一以免文字二次缩放,iPad 上需设置 ios.preferredContentMode: 'mobile'。Android 会自动应用系统字体缩放,需按 200% 重排测试(adb shell settings put system font_scale 2.0)。SPA 路由切换不会自动播报,应更新 document.title、把焦点移到 <h1 tabindex="-1"> 或使用 polite 实时区域,不要用 ScreenReader.speak 作为主要机制。原生地图、相机预览等叠加在 WebView 之上时屏幕阅读器只能看到 WebView,需在 HTML 中提供替代方案。触控目标遵循 Apple HIG 44x44 pt、Material 48x48 dp、WCAG 2.2 2.5.8 的 24x24 CSS px。prefers-reduced-motion 与 prefers-contrast 在两种 WebView 中均有效。状态变化用 role="status"/aria-live="polite",错误用 role="alert"。原生弹窗关闭后需恢复焦点。

验证方式:用 axe(npx @axe-core/cli@latest)检查并先修违规;逐屏用 VoiceOver/TalkBack、最大字号、减弱动态效果与蓝牙键盘实测;用 xcrun simctl ui booted content_size accessibility-extra-extra-extra-large 与 adb shell settings put system font_scale 2.0 检查文字是否被裁切;用 grep 检查 user-scalable=no、maximum-scale=1 与 outline: none 是否有 :focus-visible 替代。测试后恢复 adb shell settings put system font_scale 1.0 与 xcrun simctl ui booted content_size large。

限制:@capacitor/screen-reader 在 Web 上不可用(无法检测屏幕阅读器),需用 Capacitor.isNativePlatform() 判断;speak 在 Web 上可能因缺少 SpeechSynthesis 报错;text-zoom 仅限原生。具体收费、价格与平台支持细节暂未提供。