Focusable Text
This is an experimental rule, and therefore its result(s) are considered to be in beta testing. Learn more about experimental rules and how you can help improve them.
Views containing text should be focusable for assistive technologies such as TalkBack.
Impact
People using TalkBack with blindness or low-vision are most impacted. Text elements should be focusable so a screen reader can relay information to the end-user.
Confirmation
- Turn on TalkBack
- Attempt to focus the text element
- One of the following will occur:
- Inaccessible: Text element will not be focusable.
- Accessible: Text element is focused by TalkBack.
How to Fix
XML
Avoid setting the importantForAccessibility
property on text views no
. Views that people can access without assistive technology should be available for those using assistive technology.
Compose
Avoid marking Compose Text elements as invisibleToUser
. Views that people can access without assistive technology should be available for those using assistive technology.
In the example below, remove invisibleToUser
to ensure views are available to people using assistive technology.
Text("I am a text element.", modifier = Modifier.semantics {
//Remove the below API to make it accessible
invisibleToUser()
})
React Native
Text elements are accessible by default. You'll want to confirm the text is meaningful and provides context. Don't turn off accessibility by using the accessible={false}
property on the Text component directly.