aria-required-parent

Ensures elements with an ARIA role that require parent roles are contained by them.

Description

For the accessibility features to work as intended, specific ARIA roles must be contained by specific parent roles.

Why is it important?

To direct assistive technologies to handle an element differently than its default HTML element type, an element can be given an ARIA role property. For instance, a listbox control should consider a li element with the role="option" as a selectable option rather than a static list item.

If a child control’s managing control lacks the necessary parent function, people who use assistive technologies may find it challenging or impossible to use it.

How to fix?

All ARIA roles must be present within their necessary parent element. ARIA relationship properties include aria-activedescendant, aria-controls, aria-describedby, aria-flowto, aria-labelledby, aria-owns, aria-posinset, and aria-setsize.

References

• WCAG 1.3.1: Info and Relationships
• Accessibility Insights: aria-required-parent