Skip to content

Latest commit

 

History

History
28 lines (17 loc) · 1.56 KB

accessibility-guidelines.md

File metadata and controls

28 lines (17 loc) · 1.56 KB

Accessibility Guidelines

Activity titles

When an Activity comes to the foreground, TalkBack announces it’s title. When the activity has no title, TalkBack announces the name of the application which might confuse the user -> set a title to all visible activities, either in AndroidManifest or using Activity.setTitle() method.

Images

Set contentDescription attribute to all ImageViews (null is a valid value).

Illustrative images and images with labels should have contentDescription set to null -> “android:contentDescription="@null" or have importantForAccessibility set to “no” -> “android:importantForAccessibility="no".

ImageButtons with labels should have contentDescription set to null. Setting importanceForAccessibility to “no” makes them unfocusable in the accessibility mode.

Labels

When a UI element is just a label for another element, set the labelFor attribute.

Grouping content

If users should treat a set of elements as a single unit of information, you can group these elements in a focusable container (use android:focusable=”true”).

Custom Views

Make sure that custom views are accessible with both Switch Access and TalkBack. Consider implementing accessibility functionality for them using ExploreByTouchHelper.