Skip to main content

wai-aria-permitted-roles

Warns when a role is not permitted on the element according to ARIA in HTML.

This rule is part of the wai-aria rule family, split for granular severity control.

❌ Examples of incorrect code for this rule

<select role="textbox"></select>

When ARIA in HTML declares "No role permitted" for an element state, even a value matching the implicit role is rejected. For example, <img alt=""> has the implicit role presentation, but an explicit role attribute is never allowed:

<img src="spacer.png" alt="" role="presentation" /> <img src="spacer.png" alt="" role="none" />

✅ Examples of correct code for this rule

<a href="path/to" role="button">text</a> <img src="spacer.png" alt="" />

Interface

{
"wai-aria-permitted-roles": boolean
}

Default Severity

error