Nested Element Name

A focusable view should have all visible text within its accessible name available for assistive technologies such as TalkBack and Voice Access.

Impact

People using TalkBack are most impacted. Developers may add paragraphs of text to a container accessibility element, but TalkBack may not read all text within the container. Hence, people using TalkBack may not be aware of all on-screen text.

Confirmation

1. Turn on TalkBack
2. Focus on the accessibility element containing the text
3. One of the following will happen:
   • Inaccessible: TalkBack will not read the text.
   • Accessible: TalkBack will read all text contained within the focus box.

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.

Row {
    Text("Welcome to Deque")
    Text("I am a text element.", modifier = Modifier.semantics {
        //Remove the below API to make it accessible
        invisibleToUser()
    })
}