aria-allowed-attr

Ensure that elements use only ARIA attributes that are allowed for their corresponding ARIA role.

Description

Ensure that you adhere to ARIA specifications by using valid ARIA attributes and fulfilling any additional requirements specified for roles, states, and properties, such as being part of a larger structure, requiring specific attributes, or necessitating programmatically managed states.

Why is it important?

Misusing ARIA attributes in prohibited roles disrupts web page accessibility. Invalid role-attribute combinations might affect or disable accessibility for entire sections. If ARIA attributes conflict with HTML elements per WAI-ARIA 1.1, assistive technology can report nonsensical UI information, misrepresenting the document’s actual UI.

How to fix?

For details on the appropriate usage of ARIA attributes with HTML elements, refer to document conformance requirements.

References

• WCAG 4.1.2: Name, Role, Value
• Accessibility Insights: aria-allowed-attr