aria-required-attr

Ensures elements with ARIA roles have all required ARIA attributes.

Description

Required ARIA attributes must be provided.

Why is it important?

To convey the control’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.

Examples

• Success:

  • Adding aria-checked property to an element to guarantee that it consistently informs assistive technologies of the proper current status.

• Failure:

  • Setting the ARIA role attribute to “checkbox,” that is properly recognised by assistive technologies. However, the role’s necessary aria-checked state property is absent. If the checkbox is checked, assistive technology users fail to determine the state.

How to fix?

Verify that all elements have the necessary attributes specified by using the role attribute. Visit this link for more details on which ARIA role, state, and property characteristics are permitted by role.

Tags

cat.aria, wcag2a, wcag412

References

• WCAG 4.1.2: Name, Role, Value
• Deque University: aria-required-attr
• Accessibility Insights: aria-required-attr
• Evinced Digital Accessibility Knowledge Base: aria-required-attr