@codexteam/shortcuts
v1.2.0
Published
Library for handling keyboard shortcuts
Downloads
3,586
Keywords
Readme
CodeX Shortcuts
CodeX shortcuts is a micro-library for dispatching keyboard shortcuts in Javascript. You don't need external dependencies.
Installation
Package is available on NPM
npm install @codexteam/shortcuts --save
Usage
Require module if you use Webpack or ES6
const Shortcut = require('@codexteam/shortcuts');
or
import Shortcut from '@codexteam/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
.
Contribution
To contribute, please fork, add your patch and tests for it (in the test/ folder) and submit a pull request.
CodeX is a team united of passionate people who loves web development, design and marketing.
We build a full-valued projects on the world area.
Feel free to give us a feedback [email protected]
Follow us on:
Telegram: https://t.me/codex_team
Instagram: https://www.instagram.com/codex_team