The HTML aria-keyshortcuts attribute
The aria-keyshortcuts attribute lists the keyboard shortcuts that activate or focus an element, for example "Alt+Shift+P". It only announces the shortcut — you still have to implement the key handling yourself.
Overview
The aria-keyshortcuts attribute lists the keyboard shortcuts that activate or focus an element.
It is a relationship property: it wires elements together for assistive technology by referencing their ids. The element(s) you point at must exist in the DOM with matching ids, and the relationship is exposed only to assistive technology — it has no visual effect, so you still style and lay out the page normally.
Like all ARIA, aria-keyshortcuts changes only the accessibility tree — what assistive technology perceives — never the element's behavior or appearance. The first rule of ARIA applies: if a native HTML element or attribute conveys this, use that instead, and only reach for ARIA when nothing native fits.
Syntax
<button aria-keyshortcuts="Alt+S">Save</button>Values
| Value |
|---|
| A space-separated list of shortcuts, e.g. "Alt+Shift+P Control+." |
Example
<button aria-keyshortcuts="Control+S">Save</button>Best practices
- Follow the first rule of ARIA — use a native HTML element or attribute that conveys this where one exists, rather than adding ARIA.
- Reference real elements — every target
idmust exist in the DOM. - Remember the relationship is conveyed only to assistive technology and has no visual effect.
- Prefer native associations (a <label>'s
for, a <table>'s structure) where they exist.
Frequently asked questions
What does aria-keyshortcuts do?
How does this attribute reference another element?
id. The element(s) you point at must exist in the DOM with matching ids.