https://tonedear.com/js/jquery.hotkeys.js

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/*
14 * One small change is: now keys are passed by object { keys: '...' }
15 * Might be useful, when you want to pass some other data to your handler
16 */
17
18(function(jQuery){
19	
20	jQuery.hotkeys = {
21		version: "0.8",
22
23		specialKeys: {
24			8: "backspace", 9: "tab", 10: "return", 13: "return", 16: "shift", 17: "ctrl", 18: "alt", 19: "pause",
25			20: "capslock", 27: "esc", 32: "space", 33: "pageup", 34: "pagedown", 35: "end", 36: "home",
26			37: "left", 38: "up", 39: "right", 40: "down", 45: "insert", 46: "del", 
27			96: "0", 97: "1", 98: "2", 99: "3", 100: "4", 101: "5", 102: "6", 103: "7",
28			104: "8", 105: "9", 106: "*", 107: "+", 109: "-", 110: ".", 111 : "/", 
29			112: "f1", 113: "f2", 114: "f3", 115: "f4", 116: "f5", 117: "f6", 118: "f7", 119: "f8", 
30			120: "f9", 121: "f10", 122: "f11", 123: "f12", 144: "numlock", 145: "scroll", 186: ";", 191: "/",
31			220: "\\", 222: "'", 224: "meta"
32		},
33	
34		shiftNums: {
35			"`": "~", "1": "!", "2": "@", "3": "#", "4": "$", "5": "%", "6": "^", "7": "&", 
36			"8": "*", "9": "(", "0": ")", "-": "_", "=": "+", ";": ": ", "'": "\"", ",": "<", 
37			".": ">",  "/": "?",  "\\": "|"
38		}
39	};
40
41	function keyHandler( handleObj ) {
42		if ( typeof handleObj.data === "string" ) {
43			handleObj.data = { keys: handleObj.data };
44		}
45
46		// Only care when a possible input has been specified
47		if ( !handleObj.data || !handleObj.data.keys || typeof handleObj.data.keys !== "string" ) {
48			return;
49		}
50
51		var origHandler = handleObj.handler,
52			keys = handleObj.data.keys.toLowerCase().split(" "),
53			textAcceptingInputTypes = ["text", "password", "number", "email", "url", "range", "date", "month", "week", "time", "datetime", "datetime-local", "search", "color", "tel"];
54	
55		handleObj.handler = function( event ) {
56			// Don't fire in text-accepting inputs that we didn't directly bind to
57			if ( this !== event.target && (/textarea|select/i.test( event.target.nodeName ) ||
58				jQuery.inArray(event.target.type, textAcceptingInputTypes) > -1 ) ) {
59				return;
60			}
61
62			var special = jQuery.hotkeys.specialKeys[ event.keyCode ],
63				character = String.fromCharCode( event.which ).toLowerCase(),
64				modif = "", possible = {};
65
66			// check combinations (alt|ctrl|shift+anything)
67			if ( event.altKey && special !== "alt" ) {
68				modif += "alt+";
69			}
70
71			if ( event.ctrlKey && special !== "ctrl" ) {
72				modif += "ctrl+";
73			}
74			
75			// TODO: Need to make sure this works consistently across platforms
76			if ( event.metaKey && !event.ctrlKey && special !== "meta" ) {
77				modif += "meta+";
78			}
79
80			if ( event.shiftKey && special !== "shift" ) {
81				modif += "shift+";
82			}
83
84			if ( special ) {
85				possible[ modif + special ] = true;
86			}
87
88			if ( character ) {
89				possible[ modif + character ] = true;
90				possible[ modif + jQuery.hotkeys.shiftNums[ character ] ] = true;
91
92				// "$" can be triggered as "Shift+4" or "Shift+$" or just "$"
93				if ( modif === "shift+" ) {
94					possible[ jQuery.hotkeys.shiftNums[ character ] ] = true;
95				}
96			}
97
98			for ( var i = 0, l = keys.length; i < l; i++ ) {
99				if ( possible[ keys[i] ] ) {
100					return origHandler.apply( this, arguments );
101				}
102			}
103		};
104	}
105
106	jQuery.each([ "keydown", "keyup", "keypress" ], function() {
107		jQuery.event.special[ this ] = { add: keyHandler };
108	});
109
110})( this.jQuery );