Text Button Name
caution
This rule has been renamed to Button Name.
Text Button Name looks for buttons with a click action and ensures the view is focusable and its name or text is available to TalkBack.
Supported within:
Impact
People using TalkBack are most affected. The inability to focus on a view or have the view's name announced through TalkBack creates an inaccessible experience.
note
The version of Android, device, and manufacturer may play a part in issue detection.
Confirmation
- Turn on TalkBack
- Attempt to focus the control
- One of the following will happen:
- Inaccessible: Unable to focus on the control.
- Inaccessible: Focused but not announced with TalkBack.
- Accessible: Focused and announced in TalkBack.
How to Fix
Buttons should provide text for TalkBack.
@Composable
fun EmailButton() {
Button(
modifier = Modifier.semantics { this.contentDescription = “Send an Email” }
onClick = { … },
) {
Text(
text = “Email”
)
}
}