-
Notifications
You must be signed in to change notification settings - Fork 3.9k
Shortcut
Shortcut API requires node-webkit >= 0.10.0
Shortcut represents a global keyboard shortcut, also known as system-wide hot key. If register successfully, it works even if your app does not have focus. Every time the user presses the shortcut registered here, your app will receive an "active" event of the shortcut object.
// Load native UI library.
var gui = require('nw.gui');
var option = {
key : "Ctrl+Shift+A",
active : function() {
console.log("Global desktop keyboard shortcut: " + this.key + " active.");
},
failed : function(msg) {
// :(, fail to register the |key| or couldn't parse the |key|.
console.log(msg);
}
};
// Create a shortcut with |option|.
var shortcut = new gui.Shortcut(option);
// Register global desktop shortcut, which can work without focus.
gui.App.registerGlobalHotKey(shortcut);
// If register |shortcut| successfully and user struck "Ctrl+Shift+A", |shortcut|
// will get an "active" event.
// You can also add listener to shortcut's active and failed event.
shortcut.on('active', function() {
console.log("Global desktop keyboard shortcut: " + this.key + " active.");
});
shortcut.on('failed', function(msg) {
console.log(msg);
});
// Unregister the global desktop shortcut.
gui.App.unregisterGlobalHotKey(shortcut);Create new Shortcut, option is an object contains initial settings for the Shortcut. option can have following fields: key, active, failed.
Every field has its own property in the Shortcut, see documentation of each property for details.
Get or Set the key of a Shortcut. It is a string to specify the shortcut key, like "Ctrl+Alt+A".
Supported keys: A-Z, 0-9, Comma, Period, Home, End, PageUp, PageDown, Insert, Delete, Arrow keys (Up, Down, Left, Right) and the Media Keys (MediaNextTrack, MediaPlayPause, MediaPrevTrack, MediaStop). Note that Shortcut.key can have exactly one keycode.
Modifiers: Ctrl (On Mac OS X, "Ctrl" correspond to the Command keys on the Macintosh keyboard), Alt, Shift. Note that Shortcut.key takes zero or more modifiers.
Please use zero modifier only when you are knowing what your are doing. The API App.registerGlobalHotKey can support applications intercept single key (like { key: "A"}), don't do it since the users will not be able to use "A" normally any more until the app unregister it. However, the API doesn't limit this usage, and it would be useful if the applications want to listen Media Keys.
Get or Set the active callback of a Shortcut, the active must be a valid function, it will be called when user presses the shortcut.
Get or Set the failed callback of a Shortcut, the failed must be a valid function, it will be called when application pass an invalid Shortcut.key, or when the shortcut registration (App.registerGlobalHotKey) is failed.
Following events can be listened by using Shortcut.on() function, for more information on how to receive events, you can visit EventEmitter.
Emitted when user presses the registered shortcut.
Emitted when the application pass an invalid Shortcut.key, or when the shortcut registration (App.registerGlobalHotKey) is failed.