SuperAPI AI 工具集

android-accessibility

编程与开发

查看项目

更新于 10-15 15:11

技能介绍

用途

该技能用于审计和修复 Android 应用中的无障碍(Accessibility)问题,尤其针对 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() } 标记标题文本,允许屏幕阅读器用户在不同区块间跳转。

使用方式

该技能以检查清单和提示词形式提供,可直接用于指导智能体或开发者进行审查。资料中的示例提示词包括:

  • “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 界面的无障碍修复工作。

限制

资料未提供该技能的安装命令、收费方式、支持平台或具体使用步骤,这些信息暂未提供。