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.