@replace5/keyboardevent-from-electron-accelerator
v1.1.0
Published
Transform an Electron Accelerator string into a DOM KeyboardEvent.
Downloads
16
Readme
keyboardevent-from-electron-accelerator
Transform an Electron Accelerator string into a DOM KeyboardEvent.
This module export a function that take an Electron Accelerator as input and return a corresponding KeyboardEvent object.
E.g. 'Ctrl+Alt+C' => {code: 'c', ctrlKey: true, altKey: true}
Usage
This example convert a string containing an Electron Accelerator to a corresponding KeyboardEvent object. Returned object is the keyevent that would be emitted if that key combination was pressed.
const {toKeyEvent} = require('keyboardevent-from-electron-accelerator');
console.log(toKeyEvent('Shift+Delete'));
This will output
{key: 'Delete', shiftKey: true}
Context and motivation for this module.
This module is part of an ongoing effort to make electron-localshortcut less error prone, using keyboard DOM listener instead of 'globalShortcut' method to trigger shortcuts handlers.
electron-localshortcut
will listen for DOM keydown
and keyup
events, and will
trigger shortcuts handlers if emitted DOM events match the Accelerator.
This module wrap the core logic of that match operation.
You can help by testing the module on runkit and opening an issue if you found some wrong result.
API
toKeyEvent
This function transform an Electron Accelerator string into a DOM KeyboardEvent object.
Parameters
accelerator
string an Electron Accelerator string, e.g.Ctrl+C
orShift+Space
.
Returns object a DOM KeyboardEvent object derivate from the accelerator
argument.
Install
With npm installed, run
$ npm install keyboardevent-from-electron-accelerator
See Also
License
MIT