# 键盘快捷键

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

## 本地快捷键

您可以使用[Menu](/electron/api/api-jie-kou-zhi-zhu-jin-cheng-jie-kou/menu.md)模块来配置仅在应用程序集中时才触发的键盘快捷键。为此，在创建[MenuItem](/electron/api/api-jie-kou-zhi-zhu-jin-cheng-jie-kou/menu-item.md)时务必指定\[\`accelerator]属性。

```javascript
const {Menu, MenuItem} = require('electron')
const menu = new Menu()

menu.append(new MenuItem({
  label: 'Print',
  accelerator: 'CmdOrCtrl+P',
  click: () => { console.log('打印时间') }
}))
```

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

```javascript
{
  accelerator: process.platform === 'darwin' ? 'Alt+Cmd+I' : 'Ctrl+Shift+I'
}
```

## 全局快捷键

即使应用程序没有键盘焦点，也可以使用[globalShortcut](/electron/api/api-jie-kou-zhi-zhu-jin-cheng-jie-kou/global-shortcut.md)模块检测键盘事件。

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

app.on('ready', () => {
  globalShortcut.register('CommandOrControl+X', () => {
    console.log('CommandOrControl+X is pressed')
  })
})
```

## BrowserWindow中的快捷键

如果要处理[BrowserWindow](/electron/api/api-jie-kou-zhi-zhu-jin-cheng-jie-kou/browser-window.md)的键盘快捷键，可以在渲染器进程中的窗口对象上使用 `keyup` 和 `keydown` 事件侦听器。

```javascript
window.addEventListener('keyup', doSomething, true)
```

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

如果您不想手动进行快捷方式解析，那么有进行自动检测的库，如[mousetrap](https://github.com/ccampbell/mousetrap).

```javascript
Mousetrap.bind('4', () => { console.log('4') })
Mousetrap.bind('?', () => { console.log('show shortcuts!') })
Mousetrap.bind('esc', () => { console.log('escape') }, 'keyup')

// 组合
Mousetrap.bind('command+shift+k', () => { console.log('command shift k') })

// 将多个组合映射到相同的回调
Mousetrap.bind(['command+k', 'ctrl+k'], () => {
  console.log('command k or control k')

  // 返回false以防止默认行为，并阻止事件冒泡
  return false
})

//  gmail风格序列
Mousetrap.bind('g i', () => { console.log('go to inbox') })
Mousetrap.bind('* a', () => { console.log('select all') })

// konami代码
Mousetrap.bind('up up down down left right left right b a enter', () => {
  console.log('konami code')
})
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://yuzhigang5460.gitbook.io/electron/tutorial/keyboard-shortcuts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.