• Stars
    star
    100
  • Rank 340,703 (Top 7 %)
  • Language
    JavaScript
  • License
    MIT License
  • Created over 11 years ago
  • Updated almost 7 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Super simple key binding for JS

Quay: Super Simple key binding

Quay is a super simple script that allows you to easily bind key shortcuts to functions using javascript. For instance, say you had this function:

var say_hello = function() {
	alert('Hello there!');
}

You may want that function to run when a key combination is pressed on your page. Just include Quay and add the following:

var q = new Quay(window);

q.capture({
	'ctrl_alt_a':say_hello
});

And voila! Now that function will be run whenever the user presses CTRL+ALT+A on that page. Notice how Quay takes a single argument. This is the element you want to listen for key presses on. In this case a global window will suffice.

Please note: The current key combination (so above would be ctrl_alt_a) is passed as the first argument into the callback (in this case say_hello.) The event that triggered it is also passed in as a second argument

You can also use multiple key combinations for the same callback. For example:

var q = new Quay(window);

q.capture({
    'up,down,left,right': function(key) {
        alert('You pressed the ' + key + ' arrow!');
    }
})

Version

Quay is currently on version: 2.3.2

You can check the version at any time using the Quay.VERSION object. Quay.VERSION.FULL() will return the full version and Quay.VERSION.[MAJOR/MINOR/PATCH] is set to each value respectively.

Quay uses Semantic Versioning

License

Please see LICENSE.md