Keyboard & accessibility
Keyboard shortcuts
Section titled “Keyboard shortcuts”Shortcuts work when the player has focus. The player adds tabindex="0" unless you set your own.
| Key | Action |
|---|---|
| Space / K | Play / pause |
| F | Fullscreen |
| M | Mute / unmute |
| ← / → | Back / forward 5 seconds |
| ↑ / ↓ | Volume ±10% (shows the volume slider briefly) |
| Home / End | Go to the start / end |
| 0–9 | Jump to 0%–90% of the video |
| Escape | Close the modal or an open menu |
| Tab | Moves through the controls; cycles inside the modal while it’s open |
Shortcuts are ignored when Ctrl, Alt or ⌘ is pressed, so browser shortcuts keep working.
- Progress bar: a focusable
role="slider"witharia-valuenow(percent) and a readablearia-valuetextsuch as “1:23 / 4:56”. - Volume: a focusable vertical
role="slider". Arrows change the volume, Home mutes, End sets 100%. It stays visible while it has keyboard focus. - Buttons: play, mute, captions and cast update
aria-label/aria-pressed; fullscreen switches between “Fullscreen” and “Exit fullscreen”; speed and quality menus exposearia-haspopupandaria-expanded. - Modal:
role="dialog"witharia-modal="true"; focus moves inside on open, is trapped while open and returns to the previous element on close.
All labels can be translated with VegaPlayer.i18n.
Motion
Section titled “Motion”With the system setting “reduce motion”, transitions are removed and the loading spinner slows down.
Focus outlines
Section titled “Focus outlines”Keyboard focus is always visible. A mouse click on the volume button doesn’t keep the slider open (only keyboard focus does), so it never gets “stuck” on screen.