我的模块加载系统 v7
模块加载系统是我框架的核心模块的一部分,与domReady彻底地整合在一起。当然核心模块还提供了其他常用方法,如数组化,类型判定,简单的事件绑定...本版本有以下改进:
- 更改隐藏的命名空间escape(DOC.URL.split("#")[0]),为DOC.URL.replace(/(#.+|\W)/g,'');。这个命名空间被其他框架占有的机率几乎为零。
- 强化dom.log方法,让IE6也能打印日志。
- 重构fixOperaError与resolveCallbacks。
- 将provide方法合并到require中去。
通过测试的浏览器:IE6-9 FF3.6.12 FF5.1 opera11.50 safari 5 chrome14.0.8
//========================================= // 模块加载模块(核心模块)2011.8.4 by 司徒正美 //========================================= ( function (global,DOC){ var _dom = global.dom, w3c = DOC.dispatchEvent, //w3c事件模型 namespace = DOC.URL.replace(/( #.+|\W)/g,'');, HEAD = DOC.head || DOC.getElementsByTagName( "head" )[0], class2type = { "[object HTMLDocument]" : "Document" , "[object HTMLCollection]" : "NodeList" , "[object StaticNodeList]" : "NodeList" , "[object IXMLDOMNodeList]" : "NodeList" , "[object DOMWindow]" : "Window" , "null" : "Null" , "NaN" : "NaN" , "undefined" : "Undefined" }, toString = class2type.toString; /** * 糅杂,为一个对象添加更多成员 * @param {Object} target 目标对象 * @param {Object} source 属性包 * @param {Boolean|undefined} override * @return {Object} 目标对象 */ function mix(target, source, override) { var key, ride = (override === void 0) || override; for (key in source) { if (ride || !(key in target)) { target[key] = source[key]; } } return target; } /** * @class dom * dom Framework拥有两个命名空间, * 第一个是DOC.URL.split("#")[0],根据页面的地址动态生成 * 第二个是dom,我们可以使用别名机制重写它 * @namespace dom */ var dom = function (expr,context){ if ( typeof expr == "function" ){ dom.ready(expr, true ); } else { if (!dom.fn) throw "must load the 'node' module!" return new dom.fn.init(expr,context); } } mix(dom,{ uuid:1, HTML:DOC.documentElement, HEAD:HEAD, rword:/[^, ]+/g, rreadystate: /loaded|complete|undefined/i, "@name" : "dom" , "@debug" : true , "@emitter" : w3c ? "addEventListener" : "attachEvent" , /** * 别名机制(相当于jquery的noConflict) * @param {String} name 新的命名空间 */ exports: function (name) { _dom && (global.dom = _dom); name = name || dom[ "@name" ]; dom[ "@name" ] = name ; global[name] = global[namespace] = this ; }, /** * 数组化 * @param {ArrayLike} nodes 要处理的类数组对象 * @param {Number} start 可选。要抽取的片断的起始下标。如果是负数,从后面取起 * @param {Number} end 可选。规定从何处结束选取 * @return {Array} */ slice: function (nodes, start, end) { for ( var i = 0,n = nodes.length, result = []; i < n; i++){ result[i] = nodes[i]; } if (arguments.length > 1) { return result.slice(start , (end || result.length)); } else { return result; } }, /** * curry化 * @param {Any} a * @return {Function} 新函数 */ K: function (a) { return function () { return a; }; }, /** * 用于取得数据的类型或判定数据的类型 * @param {Any} obj 要检测的东西 * @param {String} str 要比较的类型 * @return {String|Boolean} */ type : function (obj, str){ var result = class2type[ (obj == null || obj !== obj )? String(obj) : toString.call(obj) ] || obj.nodeName || "#" ; if ( result.charAt(0) === "#" ){ //兼容旧式浏览器与处理个别情况,如window.opera if (obj.window==obj){ result = 'Window' ; //返回构造器名字 } else if (obj.nodeType === 9) { result = 'Document' ; //返回构造器名字 } else if ( obj.callee ){ result = 'Arguments' ; //返回构造器名字 } else if (isFinite(obj.length) && obj.item ){ result = 'NodeList' ; //处理节点集合 } else if (obj.open && obj.send ){ result = "XMLHttpRequest" ; } else { result = toString.call(obj).slice(8,-1); } } if (str){ return str === result; } return result; }, /** * 用于调试,如果是IE6直接打印到页面上 * @param {String} s 要打印的内容 * @param {Boolean} force 强制打印到页面上 */ log: function (s, force){ if (force || !global.console){ var div = DOC.body && DOC.createElement( "div" ); if (div){ div.innerHTML = s; DOC.body.appendChild(div) } } else { global.console.log(s); } }, /** * 生成键值统一的对象,用于高速化判定 * @param {Array|String} array 如果是字符串,请用","或空格分开 * @param {Number} val 可选,默认为1 * @return {Object} */ oneObject : function (array, val){ if ( typeof array == "string" ){ array = array.match(dom.rword) || []; } var result = {},value = val !== void 0 ? val :1; for ( var i=0,n=array.length;i < n;i++){ result[array[i]] = value; } return result; } }); "Boolean,Number,String,Function,Array,Date,RegExp,Window,Document,Arguments,NodeList,XMLHttpRequest" .replace(dom.rword, function (name){ class2type[ "[object " + name + "]" ] = name; }); var rmodule = /([^(\s]+)\(?([^)]*)\)?/, method = w3c ? "onload" : "onreadystatechange" , stack = [], //用于放置负回调 checks = [], //用于放置正向回调或模块本身的wrapper函数 status = {}; //用于记录每个模块加载状态0 未注册 1 已注册 2 已加载 3已执行 /** * 用于模拟opera的script onerror * @param {String} name 模块名 * @param {String} url 模块的路径 * @param {Element} node 为加载这个模块临时生成的script节点 */ function fixOperaError(name, url, node){ var iframe = DOC.createElement( "iframe" ); var code = '<script> window[document.URL.replace(/(#.+|\W)/g,"")] = {define:function(){} } <\/script>' + '<script src="' +url+ '" onload="this.ownerDocument.x = 1;"><\/script>' ; iframe.style.display = "none" ; HEAD.appendChild(iframe); var d = iframe.contentDocument; d.write(code); d.close(); iframe.onload = function (){ if (d.x == void 0){ removeScript(name, node, true ); } iframe.onload = null ; //opera无法在iframe被事件绑定时被移除 HEAD.removeChild( this ); }; } //执行并移除所有依赖都具备的模块或回调 function resolveCallbacks(){ for ( var i = checks.length, obj; obj = checks[--i]; ) { for ( var name in status){ if (status[name] == 3 && obj.deps[ "@" +name]){ delete obj.deps[ "@" +name]; obj.length--; dom[ "@debug" ] && dom.log(obj.length+ " " +name); //调试用 } } if (!obj.length){ checks.splice(i,1); //必须先移除再执行,防止在IE下DOM树建完后手动刷新页面,会多次执行最后的回调函数 obj.callback(); //装配模块到主干或执行最后的回调 } } } /** * 为加载模块而临时生成一个script节点 * @param {String} name 模块名 * @param {String} url 模块的路径 */ function appendScript(name, url){ var node = DOC.createElement( "script" ); url = url || dom.basePath + "/" + name + ".js" + (dom[ "@debug" ]? "?timestamp=" + new Date : "" ); node.charset = "utf-8" ; node.async = true ; node.onerror = function (){ removeScript(name, this , true ); } node[method] = function (){ if (dom.rreadystate.test( this .readyState) ){ resolveCallbacks(); resolveCallbacks(); //确保所有能清除的依赖都清除 removeScript(name, this ); } } node.src = url; global.opera && fixOperaError(name, url, node); HEAD.insertBefore(node,HEAD.firstChild); } /** * 移除临时生成的script节点 * @param {String} name 模块名 * @param {Element} node 为加载这个模块临时生成的script节点 * @param {Boolean} error 是否加载失败 */ function removeScript(name, node, error){ var parent = node.parentNode; if (parent && parent.nodeType === 1){ if (error || status[name] === 1){ dom.stack( 'dom.log("fail to load module [ ' +name+ ' ]")' ); dom.stack( true ); //打印错误堆栈 } if (node.clearAttributes) { node.clearAttributes(); } else { node[method] = node.onerror = null ; } parent.removeChild(node); } } mix(dom, { mix:mix, //绑定事件(简化版) bind : w3c ? function (el, type, fn, phase){ el.addEventListener(type,fn, phase); } : function (el, type, fn){ el.attachEvent( "on" +type, function (){ fn.call(el,event); }); }, stack: function (fn){ if (fn === true ){ while (fn = stack.pop()){ fn(); } } else if ( typeof fn === "string" ){ stack.push( new Function(fn)); } else if ( typeof fn === "function" ){ stack.push(fn); } }, /** * <a href="http://www.cnblogs.com/rubylouvre/archive/2011/02/10/1950940.html">核心模块所在路径</a> * @property * @type String */ basePath:( function (url, scripts, node){ scripts = DOC.getElementsByTagName( "script" ); node = scripts[scripts.length - 1]; url = node.hasAttribute ? node.src : node.getAttribute( 'src' , 4); return url.substr( 0, url.lastIndexOf( '/' )); })(), /** * 请求模块 * @param {String|Array} deps 依赖列表,如果是字符串请用逗号隔开,如果要指定具体路径请写到小括号中 * @param {Function} module 正向回调 * @param {Function} errback 负向回调 */ require: function (deps,callback,errback){ var names = []; (deps + "" ).replace(dom.rword, function (url,name,match){ match = url.match(rmodule); name = match[1]; //取得模块名 if (!status[name]){ //防止重复生成节点与请求 status[name] = 1; if (name !== "ready" ){ appendScript(name,match[2]); //加载JS文件 dom.stack(errback); //压入错误堆栈 } } if (!names[ "@" +name]){ //防止"node,oop,node"的情况 names.push(name); names[ "@" +name] = 1; } }); checks.push({ name:callback._name, callback:callback, deps:names, length:names.length }); }, /** * 定义模块 * @param {String} name 模块名 * @param {String} dependList 依赖列表 * @param {Function} module 模块本身 */ define: function (name,deps,callback){ if ( typeof deps == "function" ){ //处理只有两个参数的情况 callback = deps; deps = "" ; } status[name] = 2; function wrap(){ status[name] = 3; callback(); } wrap._name = name; //如果是空字符串则置换为空数组 this .require(deps,wrap); } }); /** * domReady机制 * @param {Function} fn 回调函数 * @param {Boolean} more 是否加载指定的模块 */ var Ready = dom.ready = function (fn){ if ( Ready.list) { Ready.list.push( fn ); } else { fn(); } }; Ready.list = []; function fireReady(){ if (Ready.list){ for ( var i=0, fn;fn = Ready.list[i++];) fn(); delete Ready.list; status.ready = 3; resolveCallbacks(); //fix opera没有执行最后的回调 } }; function doScrollCheck() { try { dom.HTML.doScroll( "left" ); fireReady(); } catch (e) { setTimeout( doScrollCheck, 0); } }; //开始判定页面的加载情况 if ( DOC.readyState === "complete" ) { fireReady(); } else { dom.bind(DOC, (w3c ? "DOMContentLoaded" : "readystatechange" ), function (){ if (w3c || DOC.readyState === "complete" ) { fireReady(); } }); try { //http://bugs.jquery.com/ticket/4787 //在IE6下,内嵌页面如果重设了document.domain,访问window.frameElement抛错, //但是经过多次try catch后,才能访问该值 var toplevel = global.frameElement == null ; } catch (e) {}; if ( dom.HTML.doScroll && toplevel ) { doScrollCheck(); } } dom.exports(); })( this , this .document); /** 2011.7.11 @开头的为私有的系统变量,防止人们直接调用, dom.check改为dom["@emitter"] dom.namespace改为dom["@name"] 去掉无用的dom.modules 优化exports方法 2011.8.4 强化dom.log,让IE6也能打印日志 重构fixOperaError与resolveCallbacks 将provide方法合并到require中去 */ |
每个模块的定义如下(请确保模块名与文件名要一致,名字不能取名为"ready",那是一个标识符,表示最后的回调函数要延迟到domReady之外才执行):
//class.js ( function (global,DOC){ var dom = global[DOC.URL.replace(/( #.+|\W)/g,'')]; dom.define( "class" , "lang" , function (){ //模块名,依赖模块的名字,模块本身 dom.log( "class模块" ) }); })( this , this .document); |
依赖于多个模块时:
//node.js ( function (global,DOC){ var dom = global[DOC.URL.replace(/( #.+|\W)/g,'')]; dom.define( "node" , "class,support,query,data" , function (){ //第二个参数也可以改成字符串数组 dom.log( "node模块" ) }); })( this , this .document); |
或者使用以下精简模式,但这也意味着让框架的别名机制报废了。
dom.define( "class" , "lang" , function (){ dom.log( "class模块" ) }); |
别名机制。像EXT那样多文件框架不能让别人占用EXT这个命名空间的,那dom Framework是怎样做到的呢?关键在于其模块的定义。每个JS文件里面都是一个Immediately-Invoked Function Expression (IIFE),这些模块依赖的是document.URL.split("#")[0]这个隐藏命名空间,而不是"dom"命名空间。如果不喜欢"dom"这个名字,想用"$"这个更大众化的名字,我们可以使用dom.exports方法进行重新命名。exports顾名思义,就是把新名字输出到全局作用域下,它也起到与jQuery的noConflict一样的作用,防止与其他框架相冲突。
dom.exports( "$" ) dom = "取消" $.require( "ready,attr" , function (){ $.log( "执行最后的回调函数" ) }); |
如果某模块的JS文件与核心模块的JS文件不在同一文件下,比如是在核心模块dom.js的所在文件夹下的ajax文件下,那它的模块名定义如下:
// 位置 ajax/base.js ( function (global,DOC){ var dom = global[DOC.URL.replace(/( #.+|\W)/g,'')]; dom.define( "ajax/base" , "ajax/jxhr" , function (){ //模块代码 }) })( this , this .document) |
如果某模块与其依赖模块不在同一台服务器下,我们可以通过"module_name(url)"这种形式来指定其地址。
( function (global,DOC){ var dom = global[DOC.URL.replace(/( #.+|\W)/g,'')]; dom.define( "css" , "lang(http://www.cnblogs.com/rubylouvre/dom/lang.js)" , function (){ //模块代码 }) })( this , this .document) |
dom.require提供了强大的负向回调支持。它拥有三个参数,依赖列表(可以是字符串数组,或由逗号或空间隔开的字符串),正向回调(当所有依赖的模块加载成功时执行),负向回调(可选,当某一个模块不存在不存在时,就立即中止整个请求链)。为了减少框架因为加载模块而为原DOM树添加多余的script节点,这些临时生成的script节点都会在模块成功加载后移除,或当请求地址不存在时,通过onerror把它移除。在opera与IE6-8下,script不支持onerror,不过我的模块加载系统 v5中已创造性地解决这问题,v7中让它们支持得更加完美!
dom.require( "ready,attr2" , function (){ alert( "执行最后的回调函数" ) }, function (){ alert( "发生错误了,并没有attr2这个模块或对应的同名JS文件" ) }); |
对第三方框架类库的支持,需要做一些修改,如jquery框架,修改如下:
( function (global,DOC){ var dom = global[DOC.URL.replace(/( #.+|\W)/g,'')]; dom.define( "jquery" , function (){ //没有依赖时,只需两个参数 //jquery源码 }); })( this , this .document); |
实践,在页面上引用dom.js这个核心模块,然后通过require调用其他你需要的模块。
<! doctype html> < html > < head > < title >并行加载器</ title > < script type="text/javascript" src="/neo/dom.js"> </ script > < script > dom.exports("$") dom = "取消" $.require("ready,attr",function(){ $.log("执行最后的回调函数") alert("111111111") }); </ script > </ head > < body > < h1 >并行加载器 by 司徒正美</ h1 > </ body > </ html > |
相关链接我的模块加载系统 v6
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· Linux系列:如何用 C#调用 C方法造成内存泄露
· AI与.NET技术实操系列(二):开始使用ML.NET
· 记一次.NET内存居高不下排查解决与启示
· 探究高空视频全景AR技术的实现原理
· 理解Rust引用及其生命周期标识(上)
· 物流快递公司核心技术能力-地址解析分单基础技术分享
· .NET 10首个预览版发布:重大改进与新特性概览!
· 单线程的Redis速度为什么快?
· 展开说说关于C#中ORM框架的用法!
· Pantheons:用 TypeScript 打造主流大模型对话的一站式集成库
2009-08-05 关于图片放大和取得尺寸