Hotkeys
5.23.0The Hotkeys API allows apps to register key combinations and receive notifications when a key combination is pressed by the user irrespectively of whether the app is on focus or not. Hotkeys are useful for web apps that don't have access to system resources and can't register global shortcuts.
The Hotkeys API is accessible through the glue.hotkeys object.
APIobject
Description
Hotkeys API
Available since version Glue42 3.6Methods
isRegisteredmethod
Signature
(hotkey: string) => void
Description
Whether the current app has registered a hotkey.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| hotkey | string | The name of the hotkey you want to check. |
registermethod
Signature
(hotkey: string | HotkeyInfo, callback: HotkeyCallback) => Promise<void>
Description
Registers a hotkey. The same hotkey can be registered just once.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| hotkey | string | HotkeyInfo | The key or key combination (as a string or as a |
|
| callback | HotkeyCallback | Callback function that will be invoked when the hotkey is activated. |
unregistermethod
Signature
(hotkey: string) => Promise<void>
Description
Unregisters a hotkey. Notifications will no longer be received about this hotkey.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| hotkey | string | The hotkey to unregister. |
unregisterAllmethod
Signature
() => Promise<void>
Description
Unregister all hotkeys registered by the current app.
HotkeyInfoobject
Description
Information about the hotkey.
Properties
| Property | Type | Default | Required | Description |
|---|---|---|---|---|
| description | string | Description of the hotkey. |
||
| hotkey | string | The key or key combination that will be used as a hotkey. |
HotkeyCallbackfunction
Signature
() => void
Description
Callback function that is invoked when the hotkey is activated.