ariaProps

Reports invalid ARIA properties.

✅ This rule is included in the jsx logical and logicalStrict presets.

If a DOM property begins with aria-, it can only be valid if it’s listed in the WAI-ARIA States and Properties specification. Any other property beginning with aria- is considered invalid and will not be handled propertly by a browser.

Common mistakes include misspelling property names, such as aria-labeledby instead of aria-labelledby.

This is required for WCAG 4.1.2 compliance.

Examples

❌ Incorrect

<input aria-labeledby="address_label" />

<div aria-invalid-prop="true" />

<button aria-labelled="Submit" />

✅ Correct

<input aria-labelledby="address_label" />

<div aria-label="Section" />

<button aria-pressed="true" />

When Not To Use It

You should always use this rule to ensure ARIA properties are valid.

Further Reading

• WCAG 4.1.2: Name, Role, Value
• WAI-ARIA States and Properties

Equivalents in Other Linters

• ESLint: jsx-a11y/aria-props
• Oxlint: jsx_a11y/aria-props