kb-handler v1.1.0

Kb-handler

    var KbHandler = require('kb-handler')

Signature

The keyboard handler constructor needs one parameter which will be the event container. Meaning that all events that occur in this context will be catched. This container needs to have the prototype method addEventListener to be working.

Thus all these instanciations are valid:

    var kb = new KbHandler(document.body)
    var kb = new KbHandler(document.createComment('event container'))
    var kb = new KbHandler(window)

Keyboard handler instance

The KbHandler instance exposes a key property which contains all keys supported. This is needed for the on function which registers events on the specified key

    kb.on(kb.key.Enter)/* conditions and actions then */ 

List of supported keys

Event methods

Once you register an event, some methods become available, providing you control about the event.

Example: This event will only trigger when the keyC will be pressed while holding Control key, will prevent the default behavior of the original event, will stop its propagation and will call the function pasteMyContent() before the function clearMyContentCopied().

So this example emulates the true Ctrl+C paste command.

    kb.on(kb.key.keyC).pressed().withCtrl().prevent().stop().do(pasteMyContent).do(clearMyContentCopied)