Skip to content
Biome
Docs Blog Playground

noAccessKey (since v1.0.0)

Diagnostic Category: lint/a11y/noAccessKey

Sources:

Enforce that the accessKey attribute is not used on any HTML element.

The accessKey assigns a keyboard shortcut to the current element. However, the accessKey value can conflict with keyboard commands used by screen readers and keyboard-only users, which leads to inconsistent keyboard actions across applications. To avoid accessibility complications, this rule suggests users remove the accessKey attribute on elements.

Examples

Section titled Examples

Invalid

Section titled Invalid
<input type="submit" accessKey="s" value="Submit" />
a11y/noAccessKey.js:1:22 lint/a11y/noAccessKey  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ Avoid the accessKey attribute to reduce inconsistencies between keyboard shortcuts and screen reader keyboard comments.
  
  > 1 │ <input type="submit" accessKey="s" value="Submit" />
      │                      ^^^^^^^^^^^^^
    2 │ 
  
  ℹ Assigning keyboard shortcuts using the accessKey attribute leads to inconsistent keyboard actions across applications.
  
  ℹ Unsafe fix: Remove the accessKey attribute.
  
    1 │ <input·type="submit"·accessKey="s"·value="Submit"·/>
      │                      --------------                 

<a href="https://webaim.org/" accessKey="w">WebAIM.org</a>
a11y/noAccessKey.js:1:31 lint/a11y/noAccessKey  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ Avoid the accessKey attribute to reduce inconsistencies between keyboard shortcuts and screen reader keyboard comments.
  
  > 1 │ <a href="https://webaim.org/" accessKey="w">WebAIM.org</a>
      │                               ^^^^^^^^^^^^^
    2 │ 
  
  ℹ Assigning keyboard shortcuts using the accessKey attribute leads to inconsistent keyboard actions across applications.
  
  ℹ Unsafe fix: Remove the accessKey attribute.
  
    1 │ <a·href="https://webaim.org/"·accessKey="w">WebAIM.org</a>
      │                               -------------               

<button accessKey="n">Next</button>
a11y/noAccessKey.js:1:9 lint/a11y/noAccessKey  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ Avoid the accessKey attribute to reduce inconsistencies between keyboard shortcuts and screen reader keyboard comments.
  
  > 1 │ <button accessKey="n">Next</button>
      │         ^^^^^^^^^^^^^
    2 │ 
  
  ℹ Assigning keyboard shortcuts using the accessKey attribute leads to inconsistent keyboard actions across applications.
  
  ℹ Unsafe fix: Remove the accessKey attribute.
  
    1 │ <button·accessKey="n">Next</button>
      │         -------------

Resources

Section titled Resources
Section titled Related links