keypress-tool

keypress-tool

Usage

˜˜˜js import KeyPress from 'keypress-tool';

// Calling it with the same parameters returns identical objects KeyPress('A', 'ctrl') === KeyPress('A', 'ctrl'); // true KeyPress('A', 'ctrl') === KeyPress('A', 'ctrl', 'shift'); // false

// Add listeners like this KeyPress('A', 'shift').addListener(ev => { console.log('Key combination pressed'); });

// Set the second parameter to true if this listener should also fire during text input KeyPress('A', 'meta').addListener(handleEvent, true);

function handleEvent(event) { console.log('Key combination pressed'); }

// Clean up (very important to avoid memory leaks) KeyPress('A', 'meta').removeListener(handleEvent);

// The default is to preventDefault. Pass 'executeDefault' if you want to change this KeyPress('A', 'executeDefault');

// Generate a short description of the key combination let k = KeyPress('A', 'ctrl', 'shift', 'alt', 'meta'); k.toString(); // 'Win+Ctrl+Alt+Shift+A' on most platforms k.toString(); // '⌃⌥⇧⌘A' on macOS ˜˜˜

Only these special keys work in fullscreen in Safari:

Tab, Enter, Space, Left, Up, Right, Down, ; = , - . / \` \[ \] '

See also:

• Quirksmode: Detecting keystrokes

Contributing

Download source and compile:

˜˜˜sh git clone [e-mail]:JannesMeyer/keypress-tool.git yarn ˜˜˜

Or compile and watch for file changes:

˜˜˜sh yarn start ˜˜˜

Run tests:

˜˜˜sh yarn test ˜˜˜

Please respect the existing formatting and indentation style. Please add tests for code that you contribute. Submit a pull request when you are done.

License

GPL v3.0