Rules for Compose Layouts

Link to Rules for Compose Layouts copied to clipboard

Learn more about the accessibility rules supported within axe DevTools for Android. Below you'll find brief descriptions of each rule along with the link to the original guidelines. Rules come from two sources:

  1. WCAG Success Criterion
  2. Best Practice - defined by Accessibility Experts at Deque

In the navigation bar under Rules & Remediation for Compose Layouts, you'll find detailed information on each rule, including resolution tips. View this guide for impact rating and descriptions. Some rules will be marked with an experimental badge. Learn more about experimental rules and how you can help improve them.

tip

Throughout our rules documentation, you'll find references to Name, Role, and Value. Please refer to WCAG's definitions.

Rule Overview

important

The Color Contrast rule uses a trained computer vision algorithm. This type of rule will only show results from views rendered on the screen at the time of the scan.

Rule & Description Guidelines Impact
Button Name

Button Name
Button Name looks for buttons with a click action and ensures the view is focusable and its name or text is available to TalkBack.

WCAG 2.0 - 4.1.2 A Critical
Color Contrast

Color Contrast
Text elements should adequately contrast with their background.

WCAG 2.0 - 1.4.3 AA Serious
Focusable Text

Focusable Text  Experimental Rule
Focusable Text identifies text elements and ensures they are available to TalkBack.

WCAG 2.0 - 1.3.2 A Critical
Inactive Accessible View

Inactive Accessible View  Experimental Rule
Clickable Compose Views with meaningful information should not be marked as invisibleToUser.

WCAG 2.0 - 4.1.2 A Critical
Label In Name

Label In Name
A view's name should be included or equal to its label.

WCAG 2.1 - 2.5.3 A Moderate
Nested Active Control

Nested Active Control  Experimental Rule
An accessibility element should not have multiple active controls embedded within it.

WCAG 2.0 - 2.1.1 A Critical
Nested Element Name

Nested Element Name  Experimental Rule
Text within an accessibility element should be read by TalkBack.

WCAG 2.0 - 1.3.2 A Critical
Switch Name

Switch Name
Switch must be paired with a label indicating its purpose.

WCAG 2.0 - 1.3.1 A Critical
Text Field Label

Text Field Label
Input fields require instructions provided for understanding and operating content.

WCAG 2.0 - 1.3.1 A Serious
Text Field Label In Name

Text Field Label In Name
A TextField's name should be included or equal to its label.

WCAG 2.1 - 2.5.3 A Serious