aria-valid-attr-value

Description

All ARIA attributes should contain only valid values. Most of the ARIA attributes have a list of expected values. If an invalid value is used in an ARIA attribute, screen readers and other assistive technologies can’t recognize the value and the webpage will become inaccessible to users of assistive technologies.

Example

In the following example, the aria-expanded attribute is defined as sometimes, which is invalid. Such invalid values for ARIA attributes make the webpage inaccessible and break the aria-valid-attr-value rule.

In contrast, the following code snippet assigns a valid value true to the aria-expanded attribute. Hence, this code snippet doesn’t break the aria-valid-attr-value rule.

How to fix?

You can follow these steps to fix issues if this rule gets flagged:

• Check if your webpage uses an invalid value for any ARIA attribute.

• If so, assign a valid value to the ARIA attribute.

Reference

• WCAG 4.1.2: Name, Role, Value
• WAI-Aria Roles
• WAI-Aria State, Properties