Icon Button Name
caution
This rule has been renamed to Button Name.
Icon 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
Pair image buttons with a content description or text to indicate its purpose.
@Composable
fun EmailIconButton() {
IconButton(
onClick = { … },
) {
Icon(
painter = painterResource(id = R.drawable.email_icon),
contentDescription = “Send an Email”
)
}
}