aria-required-childrenARIA role is missing the children it needs
Some roles must contain particular child roles, such as role="tablist" with tab children or role="listbox" with option children, or the structure isn’t announced. Add the right roles to the children, or use native elements such as <ul> and <li> that need no roles.
Who it hurts
Screen reader users, who can’t tell how many tabs or options there are, or which one is selected.
Usually a role added to the container but not to the items inside it. role="menu" on a site navigation list is a frequent case.
How to fix it
Pick your stack. Review every change before you ship it.
Before
<div role="tablist">
<button>Details</button>
<button>Delivery</button>
</div>After
<div role="tablist">
<button role="tab" aria-selected="true">Details</button>
<button role="tab" aria-selected="false" tabindex="-1">Delivery</button>
</div>Check it by hand too
Move through the widget with a screen reader on. You should hear the item type and position, such as “Delivery, tab, 2 of 3”.
Automated checks find a large share of accessibility problems, but not all of them. Passing this check does not on its own make a page compliant.
WCAG reference
- 1.3.1 Info and Relationships (Level A). Understanding 1.3.1