Rule
Required ARIA children
Composite ARIA roles must contain their required children.
- Rule
aria-required-children- WCAG 2.2
- 1.3.1 Info and Relationships (opens in a new tab) (Level A)
- Severity
- Critical
What it checks
Some ARIA roles are containers that only make sense with particular children: a list needs listitem, a tablist needs tab, a menu needs menuitem, a table needs row. The rule fails a container that holds none of the roles it needs, anywhere inside it or claimed through aria-owns. A screen reader then announces an empty or broken widget around content people can see.
An empty container passes, since it is usually waiting for content to load, and so does one marked aria-busy="true". Children inside open shadow roots and slots count.
Example
Fails
<div role="list">
<div>Apples</div>
<div>Pears</div>
</div>
Passes
<div role="list">
<div role="listitem">Apples</div>
<div role="listitem">Pears</div>
</div>
The engine is tested against both examples.
How to fix it
Give the items the role the container expects, such as role="listitem" inside role="list", or remove the container's role.
Check your own pages
This rule runs in every pour audit: the browser extension, the bookmarklet, the command line and the editor. Get pour, free.