Installation

Package is available on NPM

npm install @showgoods/shortcuts --save

Usage

Require module if you use Webpack or ES6

const Shortcut = require('@showgoods/shortcuts');

or

import Shortcut from '@showgoods/shortcuts'

Creating a shortcut

library provided as class, so to create a new shortcut, make a Shortcut instance with specified options.

Example:

let cmdA = new Shortcut({
    name : 'CMD+A',
    on : document.body,
    callback: function(event) {
        // your handler
    }
});

name - this is shortcut name, keys must be separated by +

on - binding element. Shortcut will be fired only on passed (this) element

callback - you code that defines the behaviour

If you have a single-page web application and you don't need shortcuts handler you can easily remove it

cmdA.remove();

How it works

Library parses data given on constructor, defines commands and keys.

Supported commands : shift, cmd, command, ctrl, control, windows, alt.

other words we pass as keys and special commands. Special commands are: backspace, enter, right, left, up, down, escape, insert, delete.