android-accessibility

用途

Android Accessibility Checklist 是一份用于审计和修复 Android 无障碍问题的专家清单与提示词集合，尤其针对 Jetpack Compose。它指导使用者对给定的组件或屏幕逐项检查无障碍表现，并给出对应的修复方向。

主要能力

清单覆盖以下无障碍检查维度：

1. 内容描述（Content Descriptions）

   • 检查 Image 和 Icon 可组合项是否具有有意义的 contentDescription。
   • 装饰性图片：若图片纯属装饰，应使用 contentDescription = null。
   • 可操作元素：若元素可点击，描述应说明动作（例如“Play music”），而不是描述图标本身（例如“Triangle”）。

2. 触摸目标尺寸（Touch Target Size）

   • 标准：所有交互元素最小为 48x48dp。
   • 修复：若视觉图标较小，可使用 MinTouchTargetSize，或将其包裹在具有适当内边距的 Box 中。

3. 颜色对比度（Color Contrast）

   • 标准：WCAG AA 要求普通文本达到 4.5:1，大号文本/图标达到 3.0:1。
   • 工具：使用对比度逻辑验证颜色与背景的对比。

4. 焦点与语义（Focus & Semantics）

   • 焦点顺序：确保键盘/屏幕阅读器焦点按逻辑移动（例如从 Top-Start 到 Bottom-End）。
   • 分组：对复杂项（如包含文本和图标的行）使用 Modifier.semantics(mergeDescendants = true)，使其作为单个项目被朗读。
   • 状态描述：若标准语义不足，使用 stateDescription 描述自定义状态（例如“Selected”“Checked”）。

5. 标题（Headings）

   • 遍历：用 Modifier.semantics { heading() } 标记标题文本，使屏幕阅读器用户可在各区块间跳转。

使用方式

该清单以提示词形式供代理（Agent）使用，示例提示词包括：

• “Analyze the content description of this Image. Is it appropriate?”
• “Check if the touch target size of this button is at least 48dp.”
• “Does this custom toggle button report its 'Checked' state to TalkBack?”

使用者可将待审计的组件或屏幕交给代理，并按上述检查项逐条分析，再依据清单中的修复建议进行调整。

适用场景

适用于 Android 应用开发过程中对界面进行无障碍审计与修复，特别是使用 Jetpack Compose 构建的界面。可用于检查图片与图标的内容描述、交互元素的触摸目标尺寸、文本与图标的颜色对比度、焦点顺序与语义分组、以及标题的屏幕阅读器遍历支持。

限制

资料未提供该清单的安装方式、依赖要求、支持的平台版本、收费模式或价格等信息，暂未提供。