Skip to content
Biome
Docs Blog Playground

noRedundantRoles (since v1.0.0)

Diagnostic Category: lint/a11y/noRedundantRoles

Sources:

Enforce explicit role property is not the same as implicit/default role property on an element.

Examples

Section titled Examples

Invalid

Section titled Invalid
<article role='article'></article>
a11y/noRedundantRoles.js:1:15 lint/a11y/noRedundantRoles  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ Using the role attribute 'article' on the 'article' element is redundant, because it is implied by the semantic 'article' element.
  
  > 1 │ <article role='article'></article>
      │               ^^^^^^^^^
    2 │ 
  
  ℹ Unsafe fix: Remove the role attribute.
  
    1 │ <article·role='article'></article>
      │          --------------           

<button role='button'></button>
a11y/noRedundantRoles.js:1:14 lint/a11y/noRedundantRoles  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ Using the role attribute 'button' on the 'button' element is redundant, because it is implied by the semantic 'button' element.
  
  > 1 │ <button role='button'></button>
      │              ^^^^^^^^
    2 │ 
  
  ℹ Unsafe fix: Remove the role attribute.
  
    1 │ <button·role='button'></button>
      │         -------------          

<h1 role='heading' aria-level='1'>title</h1>
a11y/noRedundantRoles.js:1:10 lint/a11y/noRedundantRoles  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ Using the role attribute 'heading' on the 'h1' element is redundant, because it is implied by the semantic 'h1' element.
  
  > 1 │ <h1 role='heading' aria-level='1'>title</h1>
      │          ^^^^^^^^^
    2 │ 
  
  ℹ Unsafe fix: Remove the role attribute.
  
    1 │ <h1·role='heading'·aria-level='1'>title</h1>
      │     ---------------

Valid

Section titled Valid
<article role='presentation'></article>
<Button role='button'></Button>
<span></span>
Section titled Related links