Skip to main content
No Result Found

Accessible elements

Accessible elements guidelines ensure that your mobile application does not rely solely on sensory cues, such as shape, size, visual location, orientation, or sound to convey information or instructions. This guideline is crucial for making your app accessible to all users, including those with disabilities that affect their sensory perceptions.

  • Rule Category : Accessibility Labels
  • WCAG 2.1 SC : 1.3.3 (A), 4.1.2 (A)
  • WCAG 2.2 SC : 1.3.3 (A), 4.1.2 (A)
  • Rule Severity : Serious
  • Supported Platforms : Android, iOS

Different aspects of Accessible elements

The Accessible elements guideline involves the following key aspects:

  • Interactive elements in the accessibility tree: All interactive elements that are visible on the screen and can be interacted with via touch should also be accessible through assistive technologies like screen readers and voice control.
  • Clear text labels for interactive elements: Provide descriptive text labels for all interactive elements. Avoid relying solely on color, shape, or sound to convey information or functionality.
  • Descriptive text for non-text content: For images, provide descriptive alt text. For videos, include captions or transcripts to ensure all users can access the content.

Currently, App Accessibility focuses on supporting the interactive elements in the accessibility tree aspect. This ensures that all interactive elements are part of the accessibility tree. This is a foundational step toward meeting both SC 1.3.3 and SC 4.1.2.

This rule is important for the following reasons:

  • Visual impairments: Users with visual impairments, including blindness and low vision may not perceive colors, shapes, sizes, or spatial orientations. If your app relies solely on these visual cues (e.g., “Press the green button on the right”), these users may struggle to navigate or interact with your app.

  • Hearing impairments: Users who are deaf or hard of hearing may miss auditory cues or instructions. Relying exclusively on sounds (e.g., a beep indicating an error) can prevent these users from receiving essential information.

  • Cognitive impairments: Users with cognitive disabilities may find it challenging to understand information presented only through complex visuals or sounds without accompanying textual explanations.

By ensuring that information and instructions are presented in ways that do not depend solely on Accessible elements, you enhance usability for a broader audience and comply with accessibility standards.

Success criteria

The rule checks if isImportantForAccessibility (Android) or isWDAccessibile (iOS) is set as true for controls or views that should be accessible.

This makes interactive elements perceivable and operable for users who rely on assistive technologies like screen readers.

Different aspects of Accessible elements

The Accessible elements guideline involves the following key aspects:

  • Interactive elements in the accessibility tree: All interactive elements that are visible on the screen and can be interacted with via touch should also be accessible through screen readers and voice control.
  • Clear text labels for interactive elements: Provide descriptive text labels for all interactive elements. Avoid relying solely on color, shape, or sound to convey information or functionality.
  • Descriptive text for non-text content: For images, provide descriptive alt text. For videos, include captions or transcripts to ensure all users can access the content.

Currently, App Accessibility focuses on supporting the interactive elements in the accessibility tree aspect. This ensures that all interactive elements are part of the accessibility tree. This is a foundational step toward meeting both SC 1.3.3 and SC 4.1.2.

How to fix

To address issues related to Accessible elements, ensure that all interactive elements are properly integrated into the accessibility tree. Here’s how you can do this across different platforms:

  • Ensure accessibility properties are set correctly: Make sure that interactive elements are not excluded from the accessibility tree by default properties or custom implementations.
  • Avoid sensory-dependent instructions: Refrain from using instructions that rely solely on sensory characteristics (e.g., “Tap the square icon to proceed”). Instead, use text labels (e.g., “Tap the ‘Next’ button”).

Example

The following example scan report shows accessible interactive elements violation in the app’s interface.

accessible interactive elements label violation

Fix

Set importantForAccessibility="yes" and provide a contentDescription for interactive elements.

Set isAccessibilityElement = true and provide an accessibilityLabel.

Wrap the label with Semantics and provide a descriptive label.

Provide an accessibilityLabel that describes the purpose.

Reference

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback

Is this page helping you?

Yes
No

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback!

Talk to an Expert
Download Copy Check Circle