Skip to main content

aria_role

Elements with ARIA roles must use a valid, non-abstract ARIA role

User impact: Serious

This rule supports the following configuration:

# All role attributes must be valid.
aria_role = true
# All role attributes must match the provided list
aria_role = [ "search", "presentation", "alert",]

Success#

<!-- Good: Valid role provided -->
<!-- aria_role = true -->
<form role="search"></form>
<!-- Good: Role matches provided options -->
<!-- aria_role = [ "table", "search", "presentation",] -->
<form role="search"></form>

Fail#

<!-- Bad: Invalid role -->
<!-- aria_role = true -->
<form role="potato"></form>
<!-- Bad: Role does not match provided options -->
<!-- aria_role = [ "table", "alert", "presentation",] -->
<form role="search"></form>

Resources#