button-name

Ensures buttons have discernible text

Description

All button elements must have accessible names.

For screen reader users, buttons must have legible text to communicate the location, goal, function, or activity in detail.

Why is it important?

The accessible name serves the purpose of providing context to users of assistive technologies, allowing them to identify and understand the functionality of the focused button element. When a button lacks an accessible label, assistive technology users cannot determine what it does.

How to fix?

Ensure all buttons have a discernible, accessible name using title, aria-label, aria-labelledby or use inner text available to assistive technologies.

References

• WCAG 4.1.2: Name, Role, Value
• Accessibility Insights: button-name