Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

JavaScript Shortcuts Library

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 README.md
Octocat-spinner-32 fix-ie6.css
Octocat-spinner-32 index.css
Octocat-spinner-32 index.html
Octocat-spinner-32 jquery.shortcuts.js
Octocat-spinner-32 jquery.shortcuts.min.js
Octocat-spinner-32 test.html
README.md

JavaScript Shortcuts Library (jQuery plugin)

Usage

Add a shortcut:

$.Shortcuts.add({
    type: 'down',
    mask: 'Ctrl+A',
    handler: function() {
        debug('Ctrl+A');
    }
});

Start reacting to shortcuts:

$.Shortcuts.start();

Add a shortcut to “another” list:

$.Shortcuts.add({
    type: 'hold',
    mask: 'Shift+Up',
    handler: function() {
        debug('Shift+Up');
    },
    list: 'another'
});

Activate “another” list:

$.Shortcuts.start('another');

Remove a shortcut:

$.Shortcuts.remove({
    type: 'hold',
    mask: 'Shift+Up',
    list: 'another'
});

Stop (unbind event handlers):

$.Shortcuts.stop();

Features

Event types

  • down — On key down (default value).
  • up — On key up.
  • hold — On pressing and holding down the key. The handler will be called immediately after pressing the key and then repeatedly while the key is held down.

Supported keys

  • Modifiers: Ctrl, Shift, Alt
  • Numbers: 0—9
  • Letters: A—Z (case-insensitive)
  • Special: Backspace, Tab, Enter, Pause, CapsLock, Esc, Space, PageUp, PageDown, End, Home, Left, Up, Right, Down, Insert, Delete, F1—F12, ? (Question Mark), Minus, Plus

Multiple key combinations and multiple lists:

$.Shortcuts.add({
    type: 'hold',
    mask: 'Shift+Up,Shift+Down',
    handler: function() {
        doSomething();
    },
    list: 'first,second'
});

Chaining:

$.Shortcuts.add({
    type: 'down',
    mask: 'Ctrl+A',
    handler: function() {
        debug('Ctrl+A');
    }
}).start();

Enable/disable shortcuts in input fields and textareas:

$.Shortcuts.add({
    type: 'down',
    mask: 'Ctrl+S',
    enableInInput: true,
    handler: function() {
        debug('Ctrl+S');
    }
});
Something went wrong with that request. Please try again.