全局快捷键

注册全局快捷键。

当 `tauri.conf.json` 文件中的 build.withGlobalTauri 设置为 true 时，此包也可以通过 `window.__TAURI__.globalShortcut` 访问。

必须将 API 添加到 `tauri.conf.json` 文件中的 tauri.allowlist.globalShortcut

{
  "tauri": {
    "allowlist": {
      "globalShortcut": {
        "all": true // enable all global shortcut APIs
      }
    }
  }
}

建议只允许列出您使用的 API，以优化包大小和安全性。

类型别名

ShortcutHandler

ShortcutHandler: (shortcut: string) => void

类型声明

(shortcut: string): void

参数

名称	类型
shortcut	string

返回值: void

定义于: globalShortcut.ts:29

函数

isRegistered

isRegistered(shortcut: string): Promise<boolean>

确定此应用程序是否注册了给定的快捷键。

示例

import { isRegistered } from '@tauri-apps/api/globalShortcut';
const isRegistered = await isRegistered('CommandOrControl+P');

自: 1.0.0

参数

名称	类型	描述
shortcut	string	快捷键定义数组，修饰符和按键用“+”分隔，例如 CmdOrControl+Q

返回值: Promise<boolean>

register

register(shortcut: string, handler: ShortcutHandler): Promise<void>

注册全局快捷键。

示例

import { register } from '@tauri-apps/api/globalShortcut';
await register('CommandOrControl+Shift+C', () => {
  console.log('Shortcut triggered');
});

自: 1.0.0

参数

名称	类型	描述
shortcut	string	快捷键定义，修饰符和按键用“+”分隔，例如 CmdOrControl+Q
handler	ShortcutHandler	快捷键处理程序回调 - 将触发的快捷键作为参数

返回值: Promise<void>

registerAll

registerAll(shortcuts: string[], handler: ShortcutHandler): Promise<void>

注册一系列全局快捷键。

示例

import { registerAll } from '@tauri-apps/api/globalShortcut';
await registerAll(['CommandOrControl+Shift+C', 'Ctrl+Alt+F12'], (shortcut) => {
  console.log(`Shortcut ${shortcut} triggered`);
});

自: 1.0.0

参数

名称	类型	描述
shortcuts	string[]	快捷键定义数组，修饰符和按键用“+”分隔，例如 CmdOrControl+Q
handler	ShortcutHandler	快捷键处理程序回调 - 将触发的快捷键作为参数

返回值: Promise<void>

unregister

unregister(shortcut: string): Promise<void>

注销全局快捷键。

示例

import { unregister } from '@tauri-apps/api/globalShortcut';
await unregister('CmdOrControl+Space');

自: 1.0.0

参数

名称	类型	描述
shortcut	string	快捷键定义，修饰符和按键用“+”分隔，例如 CmdOrControl+Q

返回值: Promise<void>

unregisterAll

unregisterAll(): Promise<void>

注销应用程序注册的所有快捷键。

示例

import { unregisterAll } from '@tauri-apps/api/globalShortcut';
await unregisterAll();

自: 1.0.0

返回值: Promise<void>