/home/edulekha/crm.edulekha.com/assets/plugins/internal/hotkeys/hotkeys.js
(function($) {
var __hotkeys_browser = undefined;
if(typeof(app) != 'undefined') {
__hotkeys_browser = app.browser;
}
/** Special keys */
var special = {
'backspace': 8,
'tab': 9,
'enter': 13,
'pause': 19,
'capslock': 20,
'esc': 27,
'space': 32,
'pageup': 33,
'pagedown': 34,
'end': 35,
'home': 36,
'left': 37,
'up': 38,
'right': 39,
'down': 40,
'insert': 45,
'delete': 46,
'f1': 112,
'f2': 113,
'f3': 114,
'f4': 115,
'f5': 116,
'f6': 117,
'f7': 118,
'f8': 119,
'f9': 120,
'f10': 121,
'f11': 122,
'f12': 123,
'?': 191, // Question mark
'minus': __hotkeys_browser == 'opera' ? [109, 45] : __hotkeys_browser == 'mozilla' ? 109 : [189, 109],
'plus': __hotkeys_browser == 'opera' ? [61, 43] : __hotkeys_browser == 'mozilla' ? [61, 107] : [187, 107]
};
/** Hash for shortcut lists */
var lists = {};
/** Active shortcut list */
var active;
/** Hash for storing which keys are pressed at the moment. Key - ASCII key code (e.which), value - true/false. */
var pressed = {};
var isStarted = false;
var getKey = function(type, maskObj) {
var key = type;
if (maskObj.ctrl) { key += '_ctrl'; }
if (maskObj.alt) { key += '_alt'; }
if (maskObj.shift) { key += '_shift'; }
var keyMaker = function(key, which) {
if (which && which !== 16 && which !== 17 && which !== 18) { key += '_' + which; }
return key;
};
if ($.isArray(maskObj.which)) {
var keys = [];
$.each(maskObj.which, function(i, which) {
keys.push(keyMaker(key, which));
});
return keys;
} else {
return keyMaker(key, maskObj.which);
}
};
var getMaskObject = function(mask) {
var obj = {};
var items = mask.split('+');
$.each(items, function(i, item) {
if (item === 'ctrl' || item === 'alt' || item === 'shift') {
obj[item] = true;
} else {
obj.which = special[item] || item.toUpperCase().charCodeAt();
}
});
return obj;
};
var checkIsInput = function(target) {
var name = target.tagName.toLowerCase();
var type = target.type;
var avInputTypes = [
'text',
'password',
'file',
'search',
'email',
'number',
'tel',
'url',
'week',
'time',
'month',
'datetime-local',
'date'
];
return (name === 'input' && $.inArray(type, avInputTypes) > -1) || name === 'textarea';
};
var run = function(type, e) {
if (!active) {
return;
}
var maskObj = {
ctrl: e.ctrlKey,
alt: e.altKey,
shift: e.shiftKey,
which: e.which
};
var key = getKey(type, maskObj);
var shortcuts = active[key]; // Get shortcuts from the active list.
if (!shortcuts) {
return;
}
var isInput = checkIsInput(e.target);
var isPrevented = false;
$.each(shortcuts, function(i, shortcut) {
// If not in input or this shortcut is enabled in inputs.
if (!isInput || shortcut.enableInInput) {
if (!isPrevented) {
e.preventDefault();
isPrevented = true;
}
shortcut.handler(e); // Run the shortcut's handler.
}
});
};
$.Shortcuts = {};
/**
* Start reacting to shortcuts in the specified list.
* @param {String} [list] List name
*/
$.Shortcuts.start = function(list) {
list = list || 'default';
active = lists[list]; // Set the list as active.
if (isStarted) {
return;
} // We are going to attach event handlers only once, the first time this method is called.
$(document).on((__hotkeys_browser == 'opera' ? 'keypress' : 'keydown') + '.shortcuts', function(e) {
// For a-z keydown and keyup the range is 65-90 and for keypress it's 97-122.
if (e.type === 'keypress' && e.which >= 97 && e.which <= 122) {
e.which = e.which - 32;
}
if (!pressed[e.which]) {
run('down', e);
}
pressed[e.which] = true;
run('hold', e);
});
$(document).on('keyup.shortcuts', function(e) {
pressed[e.which] = false;
run('up', e);
});
isStarted = true;
return this;
};
/**
* Stop reacting to shortcuts (unbind event handlers).
*/
$.Shortcuts.stop = function() {
$(document).off('keypress.shortcuts keydown.shortcuts keyup.shortcuts');
isStarted = false;
return this;
};
/**
* Add a shortcut.
* @param {Object} params Shortcut parameters.
* @param {String} [params.type] The type of event to be used for running the shortcut's handler.
* Possible values:
* down – On key down (default value).
* up – On key up.
* hold – On pressing and holding down the key. The handler will be called immediately
* after pressing the key and then repeatedly while the key is held down.
*
* @param {String} params.mask A string specifying the key combination.
* Consists of key names separated by a plus sign. Case insensitive.
* Examples: 'Down', 'Esc', 'Shift+Up', 'ctrl+a'.
*
* @param {Function} params.handler A function to be called when the key combination is pressed. The event object will be passed to it.
* @param {String} [params.list] You can organize your shortcuts into lists and then switch between them.
* By default shortcuts are added to the 'default' list.
* @param {Boolean} [params.enableInInput] Whether to enable execution of the shortcut in input fields and textareas. Disabled by default.
*/
$.Shortcuts.add = function(params) {
if (!params.mask) {
throw new Error("$.Shortcuts.add: required parameter 'params.mask' is undefined.");
}
if (!params.handler) {
throw new Error("$.Shortcuts.add: required parameter 'params.handler' is undefined.");
}
var type = params.type || 'down';
var listNames = params.list ? params.list.replace(/\s+/g, '').split(',') : ['default'];
$.each(listNames, function(i, name) {
if (!lists[name]) { lists[name] = {}; }
var list = lists[name];
var masks = params.mask.toLowerCase().replace(/\s+/g, '').split(',');
$.each(masks, function(i, mask) {
var maskObj = getMaskObject(mask);
var keys = getKey(type, maskObj);
if (!$.isArray(keys)) { keys = [keys]; }
$.each(keys, function(i, key) {
if (!list[key]) { list[key] = []; }
list[key].push(params);
});
});
});
return this;
};
/**
* Remove a shortcut.
* @param {Object} params Shortcut parameters.
* @param {String} [params.type] Event type (down|up|hold). Default: 'down'.
* @param {String} params.mask Key combination.
* @param {String} [params.list] A list from which to remove the shortcut. Default: 'default'.
*/
$.Shortcuts.remove = function(params) {
if (!params.mask) {
throw new Error("$.Shortcuts.remove: required parameter 'params.mask' is undefined.");
}
var type = params.type || 'down';
var listNames = params.list ? params.list.replace(/\s+/g, '').split(',') : ['default'];
$.each(listNames, function(i, name) {
if (!lists[name]) {
return true;
} // continue
var masks = params.mask.toLowerCase().replace(/\s+/g, '').split(',');
$.each(masks, function(i, mask) {
var maskObj = getMaskObject(mask);
var keys = getKey(type, maskObj);
if (!$.isArray(keys)) { keys = [keys]; }
$.each(keys, function(i, key) {
delete lists[name][key];
});
});
});
return this;
};
}(jQuery));