cejs

<html><head><meta http-equiv="content-type" content="text/html; charset=UTF-8"> <style> .KEYW {color: #933;} .COMM {color: #bbb; font-style: italic;} .NUMB {color: #393;} .STRN {color: #393;} .REGX {color: #339;} .line {border-right: 1px dotted #666; color: #666; font-style: normal;} </style></head><body><pre> 1 2 /* 3 本檔案為自動生成，請勿編輯！ 4 This file is auto created from _structure\structure.js, base.js, module.js, initialization.js 5 by tool: build main script. 6 */ 7 8 9 //<![CDATA[ 10 11 12 /** 13 * @name JavaScript framework: CeL base loader 14 * @fileoverview 15 * Colorless echo JavaScript kit/library base loader. 16 * 本檔案包含了呼叫其他 library 需要用到的 function，以及常用 base functions。 17 * A JavaScript module framework that is simple to use. 18 * 本計畫希望能建立一個能簡單上手的 JavaScript 模組架構。 19 * 20 * 2002-, kanashimi <kanasimi@gmail.com>. 21 * 22 * This file is in tab wide of 4 chars, documentation with JsDoc Toolkit (<a href="http://code.google.com/p/jsdoc-toolkit/wiki/TagReference">tags</a>). 23 * 24 * Please visit <a href="http://lyrics.meicho.com.tw/program/">Colorless echo program room</a> for more informations. 25 * @since 自 function.js 0.2 改寫 26 * @since JavaScript 1.2 27 * @since 2010/1/9 00:01:52 建立 28 * @author kanasimi@gmail.com 29 * @version $Id: ce.js,v 0.2 2009/11/26 18:37:11 kanashimi $ 30 */ 31 32 33 /* 34 引用：參照 35 function addCode 36 37 CeL.module 38 39 40 駝峰式大小寫命名規則 CamelCase → embedded_underscore/Snake case 41 42 43 單一JS引用： 44 // [function.js]_iF 45 function _iF(){}_iF.p='HKCU\\Software\\Colorless echo\\function.js.path';if(typeof WScript=="object")try{eval(getU((new ActiveXObject("WScript.Shell")).RegRead(_iF.p)));}catch(e){} 46 function getU(p,enc){var o;try{o=new ActiveXObject('Microsoft.XMLHTTP');}catch(e){o=new XMLHttpRequest();}if(o)with(o){open('GET',p,false);if(enc&&o.overrideMimeType)overrideMimeType('text/xml;charset='+enc);send(null);return responseText;}} 47 // [function.js]End 48 49 50 初始化：參照 51 initialization of function.js 52 53 http://www.w3school.com.cn/html5/html5_script.asp 54 <script type="text/javascript" async="true" src="path/to/function.js"></script> 55 <script type="application/javascript;version=1.7" async="true" src="path/to/function.js"></script> 56 57 JSDoc: 58 http://code.google.com/p/jsdoc-toolkit/w/list 59 http://jsdoc.sourceforge.net/ 60 61 Javadoc: 62 http://java.sun.com/j2se/javadoc/writingdoccomments/ 63 64 VSdoc: 65 JScript IntelliSense in Visual Studio 66 http://weblogs.asp.net/bleroy/archive/2007/04/23/the-format-for-javascript-doc-comments.aspx 67 http://blogs.msdn.com/b/webdevtools/archive/2008/11/07/hotfix-to-enable-vsdoc-js-intellisense-doc-files-is-now-available.aspx 68 Create JScript XML Code Comments 69 http://msdn.microsoft.com/zh-tw/library/bb514138.aspx 70 http://blog.miniasp.com/post/2010/04/Visual-Studio-2010-jQuery-Development-Tips.aspx 71 72 */ 73 74 75 76 /* 77 TODO 78 79 本 library 大量使用了 arguments.callee，但這與 ECMAScript design principles 不甚相符，需要避免。 80 http://stackoverflow.com/questions/103598/why-was-the-arguments-callee-caller-property-deprecated-in-javascript 81 http://wiki.ecmascript.org/doku.php?id=es3.1:design_principles 82 83 84 reset environment (__defineSetter__, __defineGetter__, ..) 85 in case of 86 <a href="http://haacked.com/archive/2009/06/25/json-hijacking.aspx" accessdate="2009/12/2 0:7">JSON Hijacking</a>, 87 <a href="http://blog.miniasp.com/post/2009/11/JavaScript-JSON-Hijacking.aspx" accessdate="2009/12/2 0:18">在 Web 2.0 時代必須重視 JavaScript/JSON Hijacking 攻擊</a>, 88 etc. 89 */ 90 91 92 //try{ 93 94 95 96 97 98 99 /* 100 TODO 101 將 module_name 改成 arguments 102 http://threecups.org/?p=129 103 104 listen language change event 105 play board 106 107 use <a href="http://prototyp.ical.ly/index.php/2007/03/01/javascript-design-patterns-1-the-singleton/" accessdate="2010/4/25 0:23" title="prototyp.ical.ly &raquo; Javascript Design Patterns - 1. The Singleton">Singleton pattern</a>, 108 Module 模式或單例模式（<a href="http://zh.wikipedia.org/wiki/%E5%8D%95%E4%BE%8B%E6%A8%A1%E5%BC%8F" accessdate="2010/4/25 0:25" title="单例模式">Singleton</a>）<a href="http://www.comsharp.com/GetKnowledge/zh-CN/TeamBlogTimothyPage_K950.aspx" accessdate="2010/4/25 0:24" title="那些相见恨晚的 JavaScript 技巧 - 基于 COMSHARP CMS">為 Douglas Crockford 所推崇</a>，並被大量應用在 Yahoo User Interface Library YUI。 109 110 http://wiki.forum.nokia.com/index.php/JavaScript_Performance_Best_Practices 111 http://ioio.name/core-javascript-pitfalls.html 112 113 CommonJS 114 http://www.heliximitate.cn/studyblog/archives/tag/commonjs 115 116 */ 117 118 119 /* 120 TODO 121 122 123 124 //module 125 126 //typeof CeL_id === 'string' && typeof this[CeL_id] === 'function' && 127 typeof CeL === 'function' && CeL.setup_module({ 128 name:[module_name], 129 require:[function_name,module_name], 130 131 code:function(CeL){ 132 133 var private_value=1; 134 135 function module_function_1(arg) { 136 ; 137 } 138 module_function_1.required=''; 139 140 141 function module_class_1(arg) { 142 ; 143 } 144 145 function get_value(){ 146 return private_value; 147 } 148 149 module_class_1.prototype.print=function(){}; 150 module_class_1.print=function(){}; 151 152 153 return {module_function_1,module_class_1}; 154 155 } 156 157 }); 158 159 2011/7/31 21:18:01 160 161 162 163 164 */ 165 166 //void( 167 //typeof CeL !== 'function' && 168 ( 169 /* 170 * We can redefine native values only for undefined. 171 * http://weblogs.asp.net/bleroy/archive/2006/08/02/Define-undefined.aspx 172 * 173 * Will speed up references to undefined, and allows redefining its name. (from jQuery) 174 * 175 * 用在比較或是 return undefined 176 * 在舊的 browser 中，undefined 可能不存在。 177 */ 178 function (undefined) { 179 180 /* 181 * ECMA-262 5th edition, ECMAScript 5 strict mode 182 * http://ejohn.org/blog/ecmascript-5-strict-mode-json-and-more/ 183 * http://davidflanagan.com/Talks/es5/slides.html 184 * http://kangax.github.com/es5-compat-table/ 185 */ 186 'use strict'; 187 188 189 //if(typeof global !== 'function') throw new Error('No global object specified!'); 190 191 192 var 193 library_name = 'CeL' 194 195 /** 196 * default debug level 197 * @type {Integer} 198 * @ignore 199 */ 200 , debug = 0 201 202 /** 203 * library version 204 * @type {String} 205 * @ignore 206 */ 207 , version = '2011.08.04' 208 209 //,window 210 211 , old_namespace 212 213 // library base name-space 214 , _ 215 216 //, _base_function_to_extend 217 218 , function_name_pattern 219 ; 220 221 222 // members of library ----------------------------------------------- 223 ; 224 225 226 /** 227 * Global Scope object 228 * 於 CeL.eval_code 使用 229 * @ignore 230 * @see 231 * <a href="http://stackoverflow.com/questions/3277182/how-to-get-the-global-object-in-javascript" accessdate="2011/8/6 10:7">How to get the Global Object in JavaScript? - Stack Overflow</a> 232 */ 233 var global = Function('return this')(); // isWeb()?window:this; 234 235 old_namespace = global && global[library_name]; 236 237 238 /* 239 var _Global=(function(){return this;})(); 240 _Global.JustANumber=2; // var _GlobalPrototype=_Global.constructor.prototype;_GlobalPrototype.JustANumber=2; 241 if(typeof _Global=='undefined')_Global=this; 242 for(i in _Global)alert(i); 243 */ 244 245 // 若已經定義過，跳過。因為已有對 conflict 的對策，因此跳過。 246 //if(global[library_name] !== undefined) return; 247 248 249 /** 250 * Will speed up references to DOM: window, and allows redefining its name. (from jQuery) 251 * @ignore 252 */ 253 //window = this; 254 255 256 /** 257 * 本 JavaScript framework 的框架基本宣告 258 * base name-space declaration of JavaScript library framework 259 * @example 260 * // load library 261 * <script type="text/javascript" src="../ce.js"></script> 262 * // 預防 initialization 到一半彈出警告視窗，所以設大一點。 263 * CeL.log.max_length = 20; 264 * // set debug 265 * CeL.set_debug(); 266 * 267 * // 判別是否已經 load 過 268 * if(typeof CeL !== 'function' || CeL.Class !== 'CeL') 269 * ; // CeL has not been loaded 270 * @name CeL 271 * @class Colorless echo JavaScript kit/library: base name-space declaration 272 */ 273 function _() { 274 // function CeL: library root 275 // declaration for debug 276 //this.global = arguments[0] || arguments.callee.ce_doc; 277 return new (this.init.apply(global, arguments)); 278 }; 279 280 281 // name-space 歸屬設定 282 283 /** 284 * Map over main name-space in case of overwrite (from jQuery) 285 * @ignore 286 */ 287 global[library_name] = _; 288 289 CeL 290 . 291 get_old_namespace = function(){ 292 return old_namespace; 293 }; 294 295 CeL 296 . 297 recover_namespace = function(){ 298 if (old_namespace === undefined) 299 delete global[library_name]; 300 else 301 global[library_name] = old_namespace; 302 return _; 303 }; 304 305 if (typeof _.prototype !== 'object') 306 CeL 307 . 308 /** 309 * framework main prototype definition 310 * for JSDT: 有 prototype 才會將之當作 Class 311 */ 312 prototype = { 313 }; 314 315 316 CeL 317 . 318 /** 319 * JavaScript library framework main class name. 320 * @see <a href="http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-262.pdf">ECMA-262</a>: Object.Class: A string value indicating the kind of this object. 321 * @constant 322 */ 323 Class = library_name; 324 325 326 327 328 CeL 329 . 330 /** 331 * 本 library 專用之 evaluate()。 332 * 333 * 若在 function 中 eval 以獲得 local variable，在舊 browser 中須加 var。 334 * e.g., 'var local_variable=' + .. 335 * 不加 var 在舊 browser 中會變成 global 變數。 336 * @param code script code to evaluate 337 * @returns value that evaluate process returned 338 * @see window.eval === window.parent.eval 339 * http://stackoverflow.com/questions/3277182/how-to-get-the-global-object-in-javascript 340 */ 341 eval_code = function eval_code(code) { 342 /* 343 JSC eval() takes an optional second argument which can be 'unsafe'. 344 Mozilla/SpiderMonkey eval() takes an optional second argument which is the scope object for new symbols. 345 346 use window.execScript(code,"JavaScript") in IE: window.execScript() 將直接使用全局上下文環境，因此，execScript(Str)中的字符串Str可以影響全局變量。——也包括聲明全局變量、函數以及對象構造器。 347 */ 348 //this.debug(global.eval, 2); 349 //this.debug(global && global.eval && global.eval !== arguments.callee); 350 return global && global.eval && global.eval !== eval_code ? global.eval.call(global, code) : eval(code); 351 }; 352 353 354 CeL 355 . 356 /** 357 * evaluate @ Global scope. 358 * By the ECMA-262, new Function() will 'Pass in the Global Environment as the Scope parameter.' 359 * copy from jQuery core.js 360 * @param code script code to evaluate 361 * @returns value that evaluate process returned 362 * @see 363 * <a href="http://weblogs.java.net/blog/driscoll/archive/2009/09/08/eval-javascript-global-context" accessdate="2011/8/6 8:56">Eval JavaScript in a global context | Java.net</a> 364 * use execScript on Internet Explorer 365 */ 366 global_eval = new Function('code', 'return ' 367 + (global.execScript ? 'global.execScript(' 368 : global.eval ? 'global.eval.call(global,' 369 : window && window.eval ? 'window.eval.call(window,' 370 : 'eval.call(null,') 371 + 'code);'); 372 373 374 375 CeL 376 . 377 /** 378 * simple evaluates to get value of specified variable identifier name. 379 * 不使用 eval(). 380 * @param {String} variable_name variable identifier name. e.g., /[a-z\d$_]+(.[a-z\d_]+)+/i 381 * @param {Object|Function} [name_space] initialize name-space. default: global 382 * @returns value of specified variable identifier name 383 * @since 2010/1/1 18:11:40 384 * @note 385 * 'namespace' 是 JScript.NET 的保留字 386 * 387 * 在兩個子層(a.b.c)下，這樣作效率較差 @User agent: Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US) AppleWebKit/533.4 (KHTML, like Gecko) Chrome/5.0.375.29 Safari/533.4: 388 * function(v){try{return(new Function('return('+v+')'))();}catch(e){}} 389 */ 390 get_variable = function(variable_name, name_space) { 391 //this.debug('get value of [' + variable_name + ']'); 392 if (typeof variable_name !== 'string' || !variable_name) 393 return variable_name; 394 395 var i = 0, 396 // TODO: 可處理 e.g., obj1 . obj2 [ ' obj3.4 * \[ ' ] [''] . obj5 [ " obj6 \" \' \] . " ] 397 // or detect obj1 .. obj2 398 s = variable_name.split('.'), 399 l = s.length, 400 v = name_space || 401 //this.env.global 402 global 403 ; 404 //this.debug('global.' + this.Class + ' = ' + this.env.global[this.Class]); 405 406 try { 407 while (i < l) 408 if (v) 409 // this.debug('to [' + s[i] + ']: ' + v[s[i]]), 410 v = v[s[i++]]; 411 else 412 throw 1; 413 } catch (e) { 414 s[i - 1] = '' + s[i - 1] + ''; 415 //alert(this.log.buffer.length+','+this.log.max_length+'\n'+this.debug); 416 this.debug('Cannot get [ + variable_name + '">' + s.join('.') + ']!', 2, 'get_variable'); 417 return; 418 } 419 420 return v; 421 }; 422 423 424 425 426 CeL 427 . 428 /** 429 * 取得執行 script 之 path, 在 .hta 中取代 WScript.ScriptFullName。 430 * @returns {String} 執行 script 之 path 431 * @returns '' unknown environment 432 */ 433 get_script_full_name = function() { 434 // 在 IE8, IE9 中，get_object_type.call(WScript) 為 '[object Object]' !! 435 return typeof WScript === 'object' && (!this.is_Object(WScript) || String(WScript) === 'Windows Script Host') 436 && WScript.ScriptFullName 437 || typeof location === 'object' && location === window.location && unescape(location.pathname) 438 || ''; 439 }; 440 441 CeL 442 . 443 /** 444 * 取得執行 script 之名稱 445 * @returns {String} 執行 script 之名稱 446 * @returns '' unknown environment 447 */ 448 get_script_name = function() { 449 var n, i, j; 450 451 // 在 IE8, IE9 中，get_object_type.call(WScript) 為 '[object Object]' !! 452 if (typeof WScript === 'object' 453 && (!this.is_Object(WScript) || String(WScript) === 'Windows Script Host')) { 454 n = WScript.ScriptName; 455 i = n.lastIndexOf('.'); 456 return i == -1 ? n : n.slice(0,<span c