> For AI agents: the complete documentation index is available at https://rslint.rs/llms.txt, the full documentation bundle is available at https://rslint.rs/llms-full.txt.
# role-supports-aria-props
[Added in v0.5.3](https://github.com/web-infra-dev/rslint/releases/tag/v0.5.3)
## Configuration
| Preset | Configured Value |
| ----------------------------------- | ---------------- |
| ✅ jsxA11yPlugin.configs.recommended | `"error"` |
```ts title=rslint.config.ts
import { defineConfig, jsxA11yPlugin } from '@rslint/core';
export default defineConfig([
jsxA11yPlugin.configs.recommended,
{
rules: {
'jsx-a11y/role-supports-aria-props': 'error',
},
},
]);
```
## Rule Details
Elements with ARIA roles must only use `aria-*` properties that the role supports. Many DOM elements carry an implicit ARIA role (e.g. `` → `link`, `` → `checkbox`); elements with an explicit `role` attribute carry that role directly. The supported-properties table is sourced from [`aria-query`](https://github.com/A11yance/aria-query)'s `rolesMap`.
The rule fires on a JSX opening element. It resolves the effective element name (through `settings['jsx-a11y'].polymorphicPropName` and `settings['jsx-a11y'].components`), looks up the explicit `role` attribute, and falls back to the implicit role table when no explicit `role` is set. It then walks every JSX attribute (excluding spreads and attributes whose value is `null`/`undefined`) and reports any `aria-*` attribute that is not in the role's supported-properties set.
Notable behavior locked in to mirror upstream:
- Membership against `rolesMap` is case-sensitive — `role="BUTTON"` is silently not validated because `aria-query`'s keys are lowercase.
- Mixed-case ARIA prop names (e.g. `aria-Checked`) are silently not validated for the same reason.
- Spread attributes are opaque, even when the spread argument is a literal object containing `aria-*` keys.
- Some elements have a context-sensitive implicit role: `` / `` / `` only acquire `link` when an `href` attribute is present; `` loses its `img` role when `alt=""` or the literal `src` contains `.svg`; `` / `