Skip to content
Micro-library for dispatching keyboard shortcuts in Javascript
Branch: master
Clone or download
khaydarov Merge pull request #5 from codex-team/update-license-link
Update License link on annotation
Latest commit c77b997 Apr 6, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist bump version Apr 6, 2019
example
src
.babelrc fix command execution Apr 1, 2019
.eslintrc
.gitignore
.jshintrc initial commit: basic changes Feb 6, 2018
LICENSE
README.md update CodeX description on Readme Feb 12, 2018
bundleComment.js fix command execution Apr 1, 2019
package.json bump version Apr 6, 2019
webpack.config.js fix eslint execution and bugs fix shortcut commands equality with passed Apr 5, 2019
yarn.lock update Apr 1, 2019

README.md

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 team@ifmo.su

Follow us on:

VK: https://vk.com/codex_team

Telegram: https://t.me/codex_team

Instagram: https://www.instagram.com/codex_team

You can’t perform that action at this time.