键盘快捷键

配置本地和全局键盘快捷键

本地快捷键

您可以使用Menu模块来配置仅在应用程序集中时才触发的键盘快捷键。为此,在创建MenuItem时务必指定[`accelerator]属性。

  1. const {Menu, MenuItem} = require('electron')
  2. const menu = new Menu()
  3. menu.append(new MenuItem({
  4. label: 'Print',
  5. accelerator: 'CmdOrCtrl+P',
  6. click: () => { console.log('打印时间') }
  7. }))

可以根据用户的操作系统轻松配置不同的组合键。

  1. {
  2. accelerator: process.platform === 'darwin' ? 'Alt+Cmd+I' : 'Ctrl+Shift+I'
  3. }

全局快捷键

即使应用程序没有键盘焦点,也可以使用globalShortcut模块检测键盘事件。

  1. const {app, globalShortcut} = require('electron')
  2. app.on('ready', () => {
  3. globalShortcut.register('CommandOrControl+X', () => {
  4. console.log('CommandOrControl+X is pressed')
  5. })
  6. })

BrowserWindow中的快捷键

如果要处理BrowserWindow的键盘快捷键,可以在渲染器进程中的窗口对象上使用 keyupkeydown 事件侦听器。

  1. window.addEventListener('keyup', doSomething, true)

注意第三个参数 true,这意味着监听器总是在其他监听器之前接收按键,所以它们不能对它们调用 stopPropagation()

如果您不想手动进行快捷方式解析,那么有进行自动检测的库,如mousetrap.

  1. Mousetrap.bind('4', () => { console.log('4') })
  2. Mousetrap.bind('?', () => { console.log('show shortcuts!') })
  3. Mousetrap.bind('esc', () => { console.log('escape') }, 'keyup')
  4. // 组合
  5. Mousetrap.bind('command+shift+k', () => { console.log('command shift k') })
  6. // 将多个组合映射到相同的回调
  7. Mousetrap.bind(['command+k', 'ctrl+k'], () => {
  8. console.log('command k or control k')
  9. // 返回false以防止默认行为,并阻止事件冒泡
  10. return false
  11. })
  12. // gmail风格序列
  13. Mousetrap.bind('g i', () => { console.log('go to inbox') })
  14. Mousetrap.bind('* a', () => { console.log('select all') })
  15. // konami代码
  16. Mousetrap.bind('up up down down left right left right b a enter', () => {
  17. console.log('konami code')
  18. })