require-mandatory-role-attributes.md

require-mandatory-role-attributes

✅ The extends: 'recommended' property in a configuration file enables this rule.

Elements with ARIA roles must also include all required attributes for that role. This ensures that a given element possesses the necessary states and properties to behave consistently with user expectations for other elements with the same ARIA role.

This rule enforces that elements with an ARIA role also declare all required ARIA attributes for that role.

Examples

This rule forbids the following:

<div role="option" />
<CustomComponent role="checkbox" aria-required="true" />
{{some-component role="heading"}}

This rule allows the following:

<div role="option" aria-selected="false" />
<CustomComponent role="checkbox" aria-required="true" aria-checked="false" />
{{some-component role="heading" aria-level="2"}}

References

• WAI-ARIA Roles - Accessibility _ MDN