2 KiB
2 KiB
Accelerator
Define keyboard shortcuts.
Accelerators are strings that can contain multiple modifiers and a single key code,
combined by the +
character, and are used to define keyboard shortcuts
throughout your application.
Examples:
CommandOrControl+A
CommandOrControl+Shift+Z
Shortcuts are registered with the globalShortcut
module
using the register
method, i.e.
const { app, globalShortcut } = require('electron')
app.whenReady().then(() => {
// Register a 'CommandOrControl+Y' shortcut listener.
globalShortcut.register('CommandOrControl+Y', () => {
// Do stuff when Y and either Command/Control is pressed.
})
})
Platform notice
On Linux and Windows, the Command
key does not have any effect so
use CommandOrControl
which represents Command
on macOS and Control
on
Linux and Windows to define some accelerators.
Use Alt
instead of Option
. The Option
key only exists on macOS, whereas
the Alt
key is available on all platforms.
The Super
(or Meta
) key is mapped to the Windows
key on Windows and Linux and
Cmd
on macOS.
Available modifiers
Command
(orCmd
for short)Control
(orCtrl
for short)CommandOrControl
(orCmdOrCtrl
for short)Alt
Option
AltGr
Shift
Super
Meta
Available key codes
0
to9
A
toZ
F1
toF24
- Punctuation like
~
,!
,@
,#
,$
, etc. Plus
Space
Tab
Capslock
Numlock
Scrolllock
Backspace
Delete
Insert
Return
(orEnter
as alias)Up
,Down
,Left
andRight
Home
andEnd
PageUp
andPageDown
Escape
(orEsc
for short)VolumeUp
,VolumeDown
andVolumeMute
MediaNextTrack
,MediaPreviousTrack
,MediaStop
andMediaPlayPause
PrintScreen
- NumPad Keys
num0
-num9
numdec
- decimal keynumadd
- numpad+
keynumsub
- numpad-
keynummult
- numpad*
keynumdiv
- numpad÷
key