mirror of
				https://github.com/flynx/PortableMag.git
				synced 2025-10-31 20:10:13 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			278 lines
		
	
	
		
			6.7 KiB
		
	
	
	
		
			JavaScript
		
	
	
		
			Executable File
		
	
	
	
	
			
		
		
	
	
			278 lines
		
	
	
		
			6.7 KiB
		
	
	
	
		
			JavaScript
		
	
	
		
			Executable File
		
	
	
	
	
| /**********************************************************************
 | |
| * 
 | |
| *
 | |
| *
 | |
| **********************************************************************/
 | |
| 
 | |
| //var DEBUG = DEBUG != null ? DEBUG : true
 | |
| 
 | |
| 
 | |
| 
 | |
| /*********************************************************************/
 | |
| 
 | |
| // NOTE: don't understand why am I the one who has to write this...
 | |
| var SPECIAL_KEYS = {
 | |
| 	// Special Keys...
 | |
| 	9:		'Tab',		33:		'PgUp',		45:		'Ins',		
 | |
| 	13:		'Enter',	34:		'PgDown',	46:		'Del',		
 | |
| 	16:		'Shift',	35:		'End',		80:		'Backspace',
 | |
| 	17:		'Ctrl',		36:		'Home',		91:		'Win',		
 | |
| 	18:		'Alt',		37:		'Left',		93:		'Menu',		
 | |
| 	20:		'Caps Lock',38:		'Up',	 
 | |
| 	27:		'Esc',		39:		'Right',  
 | |
| 	32:		'Space',	40:		'Down',  
 | |
| 
 | |
| 	// Function Keys...
 | |
| 	112:	'F1',		116:	'F5',		120:	'F9', 
 | |
| 	113:	'F2',		117:	'F6',		121:	'F10',
 | |
| 	114:	'F3',		118:	'F7',		122:	'F11',
 | |
| 	115:	'F4',		119:	'F8',		123:	'F12',
 | |
| }
 | |
| 
 | |
| var KEY_CODES = {}
 | |
| for(var k in SPECIAL_KEYS){
 | |
| 	KEY_CODES[SPECIAL_KEYS[k]] = k
 | |
| }
 | |
| 
 | |
| 
 | |
| // XXX some keys look really wrong...
 | |
| function toKeyName(code){
 | |
| 	// check for special keys...
 | |
| 	var k = SPECIAL_KEYS[code]
 | |
| 	if(k != null){
 | |
| 		return k
 | |
| 	}
 | |
| 	// chars...
 | |
| 	k = String.fromCharCode(code)
 | |
| 	if(k != ''){
 | |
| 		//return k.toLowerCase()
 | |
| 		return k
 | |
| 	}
 | |
| 	return null
 | |
| }
 | |
| 
 | |
| function toKeyCode(c){
 | |
| 	if(c in KEY_CODES){
 | |
| 		return KEY_CODES[c]
 | |
| 	}
 | |
| 	return c.charCodeAt(0)
 | |
| }
 | |
| 
 | |
| 
 | |
| // if set to false the event handlers will always return false...
 | |
| var KEYBOARD_HANDLER_PROPAGATE = true
 | |
| 
 | |
| /* Basic key format:
 | |
|  *
 | |
|  * 		<key-def> : <callback>,
 | |
|  *
 | |
|  * 		<key-def> : {
 | |
|  * 			'default': <callback>,
 | |
|  *			// a modifier can be any single modifier, like shift or a 
 | |
|  *			// combination of modifers like 'ctrl+shift', given in order 
 | |
|  *			// of priority.
 | |
|  *			// supported modifiers are (in order of priority):
 | |
|  *			//	- ctrl
 | |
|  *			//	- alt
 | |
|  *			//	- shift
 | |
|  * 			<modifer>: [...]
 | |
|  * 		},
 | |
|  *
 | |
|  * 		<key-def> : [
 | |
|  *			// this can be any type of handler except for an alias...
 | |
|  * 			<handler>, 
 | |
|  * 			<doc>
 | |
|  * 		],
 | |
|  *
 | |
|  *		// alias...
 | |
|  * 		<key-def-a> : <key-def-b>,
 | |
|  *
 | |
|  * <key-def> can be:
 | |
|  * 	- explicit key code
 | |
|  * 	- key name, if present in SPECIAL_KEYS)
 | |
|  * 	- key char (uppercase), as is returned by String.fromCharCode(...) 
 | |
|  *
 | |
|  *
 | |
|  * NOTE: if a handler explicitly returns false then that will break the 
 | |
|  * 		event propagation chain and exit the handler.
 | |
|  * 		i.e. no other matching handlers will be called.
 | |
|  *
 | |
|  * XXX might need to add meta information to generate sensible help...
 | |
|  */
 | |
| function makeKeyboardHandler(keybindings, unhandled){
 | |
| 	if(unhandled == null){
 | |
| 		//unhandled = function(){return false}
 | |
| 		unhandled = function(){return KEYBOARD_HANDLER_PROPAGATE}
 | |
| 	}
 | |
| 	return function(evt){
 | |
| 		var did_handling = false
 | |
| 		var res = null
 | |
| 		for(var mode in keybindings){
 | |
| 			if($(mode).length > 0){
 | |
| 				var bindings = keybindings[mode]
 | |
| 
 | |
| 				var key = evt.keyCode
 | |
| 				var chr = toKeyName(evt.keyCode)
 | |
| 				if(bindings.ignore == '*' 
 | |
| 						|| bindings.ignore != null && bindings.ignore.indexOf(key) != -1){
 | |
| 					// return true
 | |
| 					res = res == null ? true : res
 | |
| 					did_handling = true
 | |
| 					continue
 | |
| 				}
 | |
| 				// XXX ugly...
 | |
| 				var modifers = evt.ctrlKey ? 'ctrl' : ''
 | |
| 				modifers += evt.altKey ? (modifers != '' ? '+alt' : 'alt') : ''
 | |
| 				modifers += evt.shiftKey ? (modifers != '' ? '+shift' : 'shift') : ''
 | |
| 
 | |
| 				if(chr in bindings){
 | |
| 					var handler = bindings[chr]
 | |
| 				} else {
 | |
| 					var handler = bindings[key]
 | |
| 				}
 | |
| 
 | |
| 				// alias...
 | |
| 				while (typeof(handler) == typeof(123) || typeof(handler) == typeof('str')) {
 | |
| 					if(handler in bindings){
 | |
| 						// XXX need to take care of that we can always be a number or a string...
 | |
| 						handler = bindings[handler]
 | |
| 					} else if(typeof(h) == typeof(1)) {
 | |
| 						handler = bindings[toKeyName(handler)]
 | |
| 					} else {
 | |
| 						handler = bindings[toKeyCode(handler)]
 | |
| 					}
 | |
| 				}
 | |
| 				// no handler...
 | |
| 				if(handler == null){
 | |
| 					continue
 | |
| 				}
 | |
| 				// Array, lisp style with docs...
 | |
| 				// XXX for some odd reason in chrome typeof([]) == typeof({})!!!
 | |
| 				if(typeof(handler) == typeof([]) && handler.constructor.name == 'Array'){
 | |
| 					// we do not care about docs here, so just get the handler...
 | |
| 					handler = handler[0]
 | |
| 				}
 | |
| 				// complex handler...
 | |
| 				if(typeof(handler) == typeof({})){
 | |
| 					var callback = handler[modifers]
 | |
| 					if(callback == null){
 | |
| 						callback = handler['default']
 | |
| 					}
 | |
| 					if(callback != null){
 | |
| 						res = callback()
 | |
| 						did_handling = true
 | |
| 						continue
 | |
| 					}
 | |
| 				} else {
 | |
| 					// simple callback...
 | |
| 					res = handler() 
 | |
| 					// if the handler explicitly returned false break out...
 | |
| 					if(res === false){
 | |
| 						// XXX is this corrent???
 | |
| 						return KEYBOARD_HANDLER_PROPAGATE ? res : null
 | |
| 					}
 | |
| 					did_handling = true
 | |
| 					continue
 | |
| 				}
 | |
| 			}
 | |
| 		}
 | |
| 		if(!did_handling){
 | |
| 			// key is unhandled by any modes...
 | |
| 			return unhandled(key)
 | |
| 		} else {
 | |
| 			// XXX should we handle multiple hits???
 | |
| 			return KEYBOARD_HANDLER_PROPAGATE&&res?true:false
 | |
| 		}
 | |
| 	}
 | |
| }
 | |
| 
 | |
| 
 | |
| // helper...
 | |
| function doc(text, func){
 | |
| 	func.doc = text
 | |
| 	return func
 | |
| }
 | |
| 
 | |
| /* Build structure ready for conversion to HTML help.
 | |
| * Structure:
 | |
| * 	{
 | |
| * 		<section-title>: {
 | |
| * 			doc: ...
 | |
| *
 | |
| * 			<handler-doc>: <keys-spec>
 | |
| * 			...
 | |
| * 		}
 | |
| * 	}
 | |
| *
 | |
| * 	<keys-spec> 	- list of key names.
 | |
| *
 | |
| */
 | |
| function getKeyHandler(key, keybindings){
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| function buildKeyindingsHelp(keybindings){
 | |
| 	var res = {}
 | |
| 
 | |
| 	for(var selector in keybindings){
 | |
| 		var section = keybindings[selector]
 | |
| 		var title = section.title == null ? selector : section.title
 | |
| 		var res_sec = {
 | |
| 			doc: section.doc,
 | |
| 		}
 | |
| 		res.title = res_sec
 | |
| 
 | |
| 		for(var k in section){
 | |
| 			// handler...
 | |
| 			var h = section[k]
 | |
| 			var doc
 | |
| 			var key = typeof(k) == typeof(1) ? toKeyName(k) : k
 | |
| 
 | |
| 			// an alias...
 | |
| 			while(typeof(h) == typeof(1) || typeof(h) == typeof('s')){
 | |
| 				if(h in section){
 | |
| 					// XXX need to take care of that we can always be a number or a string...
 | |
| 					h = section[h]
 | |
| 				} else if(typeof(h) == typeof(1)) {
 | |
| 					h = section[toKeyName(h)]
 | |
| 				} else {
 | |
| 					h = section[toKeyCode(h)]
 | |
| 				}
 | |
| 			}
 | |
| 
 | |
| 			// no handler... 
 | |
| 			if(h == null){
 | |
| 				doc = 'Nothing'				
 | |
| 
 | |
| 			// a handler with doc (array)...
 | |
| 			} else if(typeof(h) == typeof([]) && handler.constructor.name == 'Array'){
 | |
| 				doc = h[1]
 | |
| 
 | |
| 			// complex handler (object)...
 | |
| 			} else if(typeof(h) == typeof({})){
 | |
| 				// XXX
 | |
| 				
 | |
| 
 | |
| 			// simple handler (function)...
 | |
| 			} else {
 | |
| 				doc = h.doc != null ? h.doc : h
 | |
| 
 | |
| 			}
 | |
| 
 | |
| 			// push the actual data...
 | |
| 			if(doc in res_sec){
 | |
| 				res_sec[doc].push(key)
 | |
| 			} else {
 | |
| 				res_sec[doc] = [key]
 | |
| 			}
 | |
| 		}
 | |
| 	}
 | |
| 	return res
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| /**********************************************************************
 | |
| * vim:set ts=4 sw=4 :                                                */
 |