Android Accessibility Checklist
Instructions
Analyze the provided component or screen for the following accessibility aspects.
- Content Descriptions
-
Check: Do Image and Icon composables have a meaningful contentDescription ?
-
Decorative: If an image is purely decorative, use contentDescription = null .
-
Actionable: If an element is clickable, the description should describe the action (e.g., "Play music"), not the icon (e.g., "Triangle").
- Touch Target Size
-
Standard: Minimum 48x48dp for all interactive elements.
-
Fix: Use MinTouchTargetSize or wrap in Box with appropriate padding if the visual icon is smaller.
- Color Contrast
-
Standard: WCAG AA requires 4.5:1 for normal text and 3.0:1 for large text/icons.
-
Tool: Verify colors against backgrounds using contrast logic.
- Focus & Semantics
-
Focus Order: Ensure keyboard/screen-reader focus moves logically (e.g., Top-Start to Bottom-End).
-
Grouping: Use Modifier.semantics(mergeDescendants = true) for complex items (like a row with text and icon) so they are announced as a single item.
-
State descriptions: Use stateDescription to describe custom states (e.g., "Selected", "Checked") if standard semantics aren't enough.
- Headings
- Traversal: Mark title texts with Modifier.semantics { heading() } to allow screen reader users to jump between sections.
Example Prompts for Agent Usage
-
"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?"