Label In Name

Link to Label In Name copied to clipboard

WCAG 2.1 - 2.5.3 A Impact - Moderate

People using assistive technology should have the same understanding of labels as people not using assistive technology.

Supported within:
Compose Layouts

Impact

Issues detected by this rule contribute to a confusing or conflicting experience between the announcement from TalkBack and the content available on the screen.

Confirmation

  1. Turn on TalkBack
  2. Attempt to focus the control
  3. One of the following will happen:
    • Inaccessible: Text announced by TalkBack is different from the displayed widget's name.
    • Accessible: Text announced by TalkBack is the same or includes the displayed widget's name.

How to Fix

Ensure the widget's contentDescription contains the name of the view.

@Composable
fun EmailButton() {
    Button(
        modifier = Modifier.semantics { this.contentDescription = “Send an Email” }
        onClick = {},
    ) { 
        Text(
            text = “Email”
        )
    }
}