/keymaster

keymaster.js is a simple micro-library for defining and dispatching keyboard shortcuts. It has no dependencies.

Primary LanguageJavaScriptMIT LicenseMIT

keymaster.js

keymaster.js is a simple (~60 LoC) micro-library for defining and dispatching keyboard shortcuts. It has no dependencies.

It’s a work in progress, so spare me your nerdrage and instead contribute! Patches are welcome, but they are not guaranteed to make it in.

Two global methods are exposed, key for defining shortcuts, and keyScope for switching scope.

See test.html for a live demo.

key('c', 'issues', function(){
 console.log('c/issues');
});

key('command+r, ctrl+r', 'issues', function(){
  console.log('Hijacked Command+R or Ctrl+R, damn!');
  return false;
});

key('i', function(){
  keyScope('issues');
  console.log('Switched to "issues" scope. Command+R or Ctrl+R is now no longer reloading...');
});

key('i', function(){
  console.log('(example of multiple assignment)');
});

key('o, enter, left', function(){
  console.log('o, enter or left pressed!');
});

key('ctrl+c', function(){
  console.log('this is not the command line');
});

key('⌘+right,shift+left,ctrl+shift+alt+d', function(event){
  console.log('command+right, or shift+left, or ctrl+shift+alt+d');
  console.log('here is the event: ', event);
  return false; // prevent default && stop propagation
});

TODO

  • Make behavior with INPUT / SELECT / TEXTAREA configurable
  • Comprehensive test suite
  • Make it work on IE (7+) (low priority)

keymaster.js is (c) 2011 Thomas Fuchs and may be freely distributed under the MIT license. See the MIT-LICENSE file.