aria-required-attr

Elements with ARIA roles must have appropriate attributes describing their state or properties.

Description

Widget roles in ARIA need to be equipped with suitable attributes that detail their state or properties. Such attributes offer crucial context to assistive technologies, allowing them to communicate the widget’s current state or functionality to users with disabilities effectively.

Why is it important?

To convey the widget’s attributes or current state, some ARIA role attributes need additional ARIA attributes. When an element lacks an important ARIA property, assistive technology users may find it difficult or impossible to use it. Example: A <div> element has a role="menu" attribute to indicate that it serves as a menu widget. The aria-labelledby attribute associates the menu with an accessible label providing a descriptive name for the menu. The aria-orientation= "vertical" attribute specifies the orientation of the menu.

How to fix?

Verify that all elements have the necessary ARIA attributes specified while using the role attribute. Visit this link for more details.

References

• WCAG 4.1.2: Name, Role, Value
• Accessibility Insights: aria-required-attr