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