Skip to content

useAriaPropsSupportedByRole

¥Summary

¥How to configure

biome.json
{
"linter": {
"rules": {
"a11y": {
"useAriaPropsSupportedByRole": "error"
}
}
}
}

¥Description

强制 ARIA 属性对于元素支持的角色有效。

¥Enforce that ARIA properties are valid for the roles that are supported by the element.

无效的 ARIA 属性会使辅助技术的用户难以理解元素的用途。

¥Invalid ARIA properties can make it difficult for users of assistive technologies to understand the purpose of the element.

¥Examples

¥Invalid

<a href="#" aria-checked />
code-block.jsx:1:1 lint/a11y/useAriaPropsSupportedByRole ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

The ARIA attribute ‘aria-checked’ is not supported by this element.

> 1 │ <a href=”#” aria-checked />
^^^^^^^^^^^^^^^^^^^^^^^^^^^
2 │

Ensure that ARIA attributes are valid for the role of the element.

<img alt="foobar" aria-checked />
code-block.jsx:1:1 lint/a11y/useAriaPropsSupportedByRole ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

The ARIA attribute ‘aria-checked’ is not supported by this element.

> 1 │ <img alt=“foobar” aria-checked />
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2 │

Ensure that ARIA attributes are valid for the role of the element.

¥Valid

<>
<a href="#" aria-expanded />
<img alt="foobar" aria-hidden />
<div role="heading" aria-level="1" />
</>

¥Related links