Skip to main content

wai-aria-disallowed-props

Warns when an ARIA property or state is not allowed on the element's computed role. Also enforces the "naming prohibition" constraint defined by ARIA in HTML: elements without an implicit role (such as <cite>, <abbr>, <figcaption>) must not use aria-label, aria-labelledby, or aria-braillelabel unless an explicit role that supports naming is set.

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

❌ Examples of incorrect code for this rule

<div role="heading" aria-pressed="true"></div>
<cite aria-label="x">y</cite>

✅ Examples of correct code for this rule

<div role="button" aria-pressed="true"></div>
<cite role="button" aria-label="x">y</cite>

Interface

{
"wai-aria-disallowed-props": boolean
}

Default Severity

error