Skip to main content

단축키 설정

단축키는 애플리케이션 전반에 걸쳐 키보드 명령을 정의할 때 사용한다. 단축키는 여러 개의 수정자(modifier)와 하나의 키 코드를 + 문자로 조합한 문자열로 구성된다. 단축키는 대소문자를 구분하지 않는다.

예시:

  • CommandOrControl+A
  • CommandOrControl+Shift+Z

단축키는 globalShortcut 모듈의 register 메서드를 사용해 등록한다. 예를 들어:

const { app, globalShortcut } = require('electron')

app.whenReady().then(() => {
// 'CommandOrControl+Y' 단축키 리스너 등록
globalShortcut.register('CommandOrControl+Y', () => {
// Y 키와 Command/Control 키가 눌렸을 때 실행할 동작
})
})

플랫폼별 주의사항

리눅스와 윈도우에서는 Command 키가 동작하지 않는다. 따라서 macOS에서는 Command를, 리눅스와 윈도우에서는 Control을 의미하는 CommandOrControl을 사용해 단축키를 정의한다.

Option 대신 Alt를 사용한다. Option 키는 macOS에만 존재하지만, Alt 키는 모든 플랫폼에서 사용 가능하다.

Super(또는 Meta) 키는 윈도우와 리눅스에서는 Windows 키에, macOS에서는 Cmd 키에 매핑된다.

사용 가능한 수정자

  • Command (줄여서 Cmd)
  • Control (줄여서 Ctrl)
  • CommandOrControl (줄여서 CmdOrCtrl)
  • Alt
  • Option
  • AltGr
  • Shift
  • Super
  • Meta

사용 가능한 키 코드

  • 0부터 9
  • A부터 Z
  • F1부터 F24
  • 다양한 구두점: ), !, @, #, $, %, ^, &, *, (, :, ;, :, +, =, <, ,, _, -, >, ., ?, /, ~, `, {, ], [, |, \, }, "
  • Plus
  • Space
  • Tab
  • Capslock
  • Numlock
  • Scrolllock
  • Backspace
  • Delete
  • Insert
  • Return (또는 Enter로도 사용)
  • Up, Down, Left, Right
  • HomeEnd
  • PageUpPageDown
  • Escape (또는 줄여서 Esc)
  • VolumeUp, VolumeDown, VolumeMute
  • MediaNextTrack, MediaPreviousTrack, MediaStop, MediaPlayPause
  • PrintScreen
  • 숫자 패드 키
    • num0 - num9
    • numdec - 소수점 키
    • numadd - 숫자 패드 +
    • numsub - 숫자 패드 -
    • nummult - 숫자 패드 *
    • numdiv - 숫자 패드 ÷