aria-required-children

Ensures elements with an ARIA role that require child roles contain them.

Description

To make the webpage accessible, some ARIA parent role values applied to elements must contain specific child elements and role values.

Why is it important?

Roles within ARIA that lack the necessary child roles will be incapable of executing the intended accessibility functions as envisioned by the developer. The permissible and/or obligatory child and parent roles for each role is defined in WAI-ARIA: The Roles Model document.

How to fix?

Confirm elements, with explicit or implicit ARIA roles, to include necessary child elements. For example, attributes like aria-activedescendant, aria-controls, aria-describedby, aria-flowto, aria-labelledby, aria-owns, aria-posinset, aria-setsize, and role="combobox" denote relationships that are not evident from document structure. Visit WAI-ARIA Authoring Practices 1.1: Design Patterns and Widgets for more details about composite widgets and their required roles.

References

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