      1 /*
      2  * jQuery Hotkeys Plugin
      3  * Copyright 2010, John Resig
      4  * Dual licensed under the MIT or GPL Version 2 licenses.
      5  *
      6  * Based upon the plugin by Tzury Bar Yochay:
      7  * http://github.com/tzuryby/hotkeys
      8  *
      9  * Original idea by:
     10  * Binny V A, http://www.openjs.com/scripts/events/keyboard_shortcuts/
     11 */
     12
     13 (function(jQuery){
     14
     15 	jQuery.hotkeys = {
     16 		version: "0.8",
     17
     18 		specialKeys: {
     19 			8: "backspace", 9: "tab", 13: "return", 16: "shift", 17: "ctrl", 18: "alt", 19: "pause",
     20 			20: "capslock", 27: "esc", 32: "space", 33: "pageup", 34: "pagedown", 35: "end", 36: "home",
     21 			37: "left", 38: "up", 39: "right", 40: "down", 45: "insert", 46: "del",
     22 			96: "0", 97: "1", 98: "2", 99: "3", 100: "4", 101: "5", 102: "6", 103: "7",
     23 			104: "8", 105: "9", 106: "*", 107: "+", 109: "-", 110: ".", 111 : "/",
     24 			112: "f1", 113: "f2", 114: "f3", 115: "f4", 116: "f5", 117: "f6", 118: "f7", 119: "f8",
     25 			120: "f9", 121: "f10", 122: "f11", 123: "f12", 144: "numlock", 145: "scroll", 191: "/", 224: "meta"
     26 		},
     27
     28 		shiftNums: {
     29 			"`": "~", "1": "!", "2": "@", "3": "#", "4": "$", "5": "%", "6": "^", "7": "&",
     30 			"8": "*", "9": "(", "0": ")", "-": "_", "=": "+", ";": ": ", "'": "\"", ",": "<",
     31 			".": ">",  "/": "?",  "\\": "|"
     32 		}
     33 	};
     34
     35 	var defaultOptions = {
     36         key : '',
     37         enabledInInput : false
     38     };
     39
     40 	function keyHandler( handleObj ) {
     41 		var options = ( typeof handleObj.data == "string" ) ? {key: handleObj.data} : handleObj.data;
     42 		options = jQuery.extend({}, defaultOptions, options);
     43
     44 		var origHandler = handleObj.handler,
     45 			keys = options.key.toLowerCase().split(" ");
     46
     47 		// when no key binding is defined
     48 		if (keys.length === 1 && keys[0] === '') {
     49 		    return;
     50 		}
     51
     52 		handleObj.handler = function( event ) {
     53 			var character = String.fromCharCode( event.which ).toLowerCase(),
     54 					isTextInput = (/textarea|select/i.test( event.target.nodeName ) || event.target.type === "text");
     55 			// Don't fire in text-accepting inputs that we didn't directly bind to
     56 			if ( this !== event.target && isTextInput && !options.enabledInInput ) {
     57 				return;
     58 			}
     59
     60 			// Keypress represents characters, not special keys
     61 			var special = event.type !== "keypress" && jQuery.hotkeys.specialKeys[ event.which ],
     62 				key, modif = "", possible = {};
     63
     64 			// check combinations (alt|ctrl|shift+anything)
     65 			if ( event.altKey && special !== "alt" ) {
     66 				modif += "alt+";
     67 			}
     68
     69 			if ( event.ctrlKey && special !== "ctrl" ) {
     70 				modif += "ctrl+";
     71 			}
     72
     73 			// TODO: Need to make sure this works consistently across platforms
     74 			if ( event.metaKey && !event.ctrlKey && special !== "meta" ) {
     75 				modif += "meta+";
     76 			}
     77
     78 			if ( event.shiftKey && special !== "shift" ) {
     79 				modif += "shift+";
     80 			}
     81
     82 			if ( special ) {
     83 				possible[ modif + special ] = true;
     84
     85 			} else {
     86 				possible[ modif + character ] = true;
     87 				possible[ modif + jQuery.hotkeys.shiftNums[ character ] ] = true;
     88
     89 				// "$" can be triggered as "Shift+4" or "Shift+$" or just "$"
     90 				if ( modif === "shift+" ) {
     91 					possible[ jQuery.hotkeys.shiftNums[ character ] ] = true;
     92 				}
     93 			}
     94 			for ( var i = 0, l = keys.length; i < l; i++ ) {
     95 				if ( possible[ keys[i] ] ) {
     96 					return origHandler.apply( this, arguments );
     97 				}
     98 			}
     99 		};
    100 	}
    101
    102 	jQuery.each([ "keydown", "keyup", "keypress" ], function() {
    103 		jQuery.event.special[ this ] = { add: keyHandler };
    104 	});
    105
    106 })( jQuery );
    107