Dojo-0.3.1debug版本部分翻译
发布时间:2020-12-16 21:55:02 所属栏目:百科 来源:网络整理
导读:没事的时候翻译的,当阅读做了。倒~!! if ( typeof dojo == " undefined " ){ /* * *@文件bootstrap1.js * *摘要:整套Dojo库载入的第一个文件。 //**************************************************************** //note:必须运行于hostenv_*.js文件
没事的时候翻译的,当阅读做了。倒~!!
if
(
typeof
dojo
==
"
undefined
"
){
/* * *@文件bootstrap1.js * *摘要:整套Dojo库载入的第一个文件。 //**************************************************************** //note:必须运行于hostenv_*.js文件之前。(说的是src目录下的文件,它们从都是从此文档的分割出去的) //**************************************************************** * *@作者Copyright2004MarkD.Anderson(mda@discerning.com) *TODOC:可以在Dojo基础上做改动吗? *@许可协议在AcademicFreeLicense2.1(http://www.opensource.org/licenses/afl-2.1.php)许可协议下。 * *$Id:bootstrap1.js43422006-06-1123:03:30Zalex$ */ // TODOC:HOWTODOCTHEBELOW? // @全局:djConfig // 摘要: // 载入库时,应用程序代码可以先设置全局变量"djConfig"来取消某个Dojo运作方式的全局设定。 // 说明:可以设定如下全局变量: // -isDebug:false // -allowQueryConfig:false // -baseScriptUri:"" // -baseRelativePath:"" // -libraryScriptUri:"" // -iePreventClobber:false // -ieClobberMinimal:true // -preventBackButtonFix:true // -searchIds:[] // -parseWidgets:true // TODOC:HOWTODOCTHESEVARIABLES? // TODOC:ISTHISACOMPLETELIST? // 注意: // 在有"dojo.*"时,"djConfig"不存在。因此,在"dojo"变量存在前可以被设定。 // 注意: // 在载入库之后设定这些变量,都不起任何作用。 // TODOC:现在仍然如此吗?版本0.3的发行说明指出载入后仍可设定。. // // TODOC:HOWTODOCTHIS? // @全局:dj_global // 摘要: // 主环境的顶层全局对象的别名 // (例如:浏览器的window对象)。 // 说明: // 使用"dj_global"而不是window对象,是为了保证你的代码在上下文中可以正确运行,而不是指哪些浏览器。(eg:Rhinoonaserver). var dj_global = this ; function dj_undef( /* String */ name, /* Object? */ object){ // 摘要:如果在"object"对象上定义了为参数"name"的属性,返回false(或者在全局范围,"object"对象为null)。 // 说明:注意定义和存在是两个不同的概念。 if (object == null ){object = dj_global;} // 如果object不是一个对象时发生异常。 return ( typeof object[name] == " undefined " ); // Boolean } // 确保定义了djConfig if (dj_undef( " djConfig " )){ var djConfig = {}; } // TODOC:HOWTODOCTHIS? // dojo是我们使用库中几乎所有公共标志的根变量——确保定义 if (dj_undef( " dojo " )){ var dojo = {}; } // TODOC:HOWTODOCTHIS? dojo.version = { // 摘要:当前dojo实例的版本号。 major: 0 ,minor: 3 ,patch: 1 ,flag: "" , revision:Number( " $Rev:4342$ " .match( / [ 0 - 9 ] +/ )[ 0 ]), // 找到字符串中的数字匹配返回的字符串数组的第1个元素,并转化成数值类型 toString: function (){ with (dojo.version){ return major + " . " + minor + " . " + patch + flag + " ( " + revision + " ) " ; // String } } } dojo.evalProp = function ( /* String */ name, /* Object */ object, /* Boolean? */ create){ // 摘要:返回"object[name]".如果没有定义并且"create"为true,会返回一个新对象。 // 说明: // 如果没有定义"object[name]"并且"create"不为true,返回null。 // 注意:定义和存在是两个不同的概念。 // 注意:对象的属性也是对象。 return (object && ! dj_undef(name,object) ? object[name]:(create ? (object[name] = {}):undefined)); // mixed } dojo.parSEObjPath = function ( /* String */ path, /* Object? */ context, /* Boolean? */ create){ // 摘要:解析字符串path并成返回一个对象,它带有对应的对象引用及属性名称。 // 说明: // 返回一个带有"obj"和"prop"两个属性的对象。 // 参照"path"指出"obj[prop]"。 // path:一个对象的Path是以"A.B.C"的形式。 // context:作用类似根目录的对象,默认是"dj_global"。 // create:如果为true,就会沿"path",为那些没有定义的点创建一些新对象。 var object = (context != null ? context:dj_global); var names = path.split( ' . ' ); var prop = names.pop(); // 弹出数组的最后一个元素并返回,并将数组长度减1。 for ( var i = 0 ,l = names.length;i < l && object;i ++ ){ object = dojo.evalProp(names[i],object,create); } return {obj:object,prop:prop}; // Object:{obj:Object,prop:String} } dojo.evalObjPath = function ( /* String */ path, /* Boolean? */ create){ // 摘要:Returnthevalueofobjectat'path'intheglobalscope,withoutusing'eval()'. // 摘要:返回全局范围内在"path"上的对象的值,没有使用"eval()"。 // path:一个对象的Path是以"A.B.C"的形式。 // create:如果为true,就会沿"path",为那些没有定义的点创建一些新对象。 if ( typeof path != " string " ){ return dj_global; } // 没有句点号的快速路径 if (path.indexOf( ' . ' ) == - 1 ){ return dojo.evalProp(path,dj_global,create); // mixed } // MOW:过去的"with"句法有些混乱。并且,如果parSEObjPath返回了null,还会抛出一个错误。 var ref = dojo.parSEObjPath(path,create); if (ref){ return dojo.evalProp(ref.prop,ref.obj,create); // mixed } return null ; } // **************************************************************** // globalpublicutils(全局公有调用) // TODOC:DOWEWANTTONOTETHATTHESEAREGLOBALPUBLICUTILS?(我们需要记住这些是公有调用吗?) // **************************************************************** dojo.errorToString = function ( /* Error */ exception){ // 摘要:返回异常的'message','note'ortext. // TODO:如果没有Error.prototype.toString将不能实现吗? // ...因为这是生来造成的错误,所以对象不就总是招来这些事吗? if ( ! dj_undef( " message " ,exception)){ return exception.message; // String } else if ( ! dj_undef( " note " ,exception)){ return exception.note; // String } else { return exception; // Error } } dojo.raise = function ( /* String */ message, /* Error? */ exception){ // 摘要:抛出一个错误消息。如果被支持,还在文字的后面附加上"exception"的内容。 // 注意:还会使用"dojo.hostenv.println"向用户打出消息的内容。 if (exception){ message = message + " : " + dojo.errorToString(exception); } // 如果使用"dojo.hostenv.println",能向用户打出消息。 try {dojo.hostenv.println( " FATAL: " + message);} catch (e){} throw Error(message); } // 已经废除的一些方法,所以不起作用了 // TODOC:HOWTODOCTHESE? dojo.debug = function (){} dojo.debugShallow = function (obj){} dojo.profile = {start: function (){},end: function (){},stop: function (){},dump: function (){}}; function dj_eval( /* String */ scriptFragment){ // 摘要:使用全局范围内的评估方法。这没有直接调用"eval()"。 // 说明:放在一个单独的方法里,减小评估上下文的大小。 // 注意: // -JSCeval()给出了可选的第二个参数,可以取"unsafe"。 // -Mozilla/SpiderMonkeyeval()给出了一个可选的第二个参数,作为新代码符号所属的特定范围的对象。 return dj_global.eval ? dj_global.eval(scriptFragment):eval(scriptFragment); // mixed } dojo.unimplemented = function ( /* String */ funcname, /* String? */ extra){ // 摘要:抛出由于某个方法没有实现而产生的异常 // extra:附加在异常消息message后的内容。 var message = " ' " + funcname + " 'notimplemented " ; if (extra != null ){message += " " + extra;} dojo.raise(message); } dojo.deprecated = function ( /* String */ behaviour, /* String? */ extra, /* String? */ removal){ // 摘要:记录指出一个已经被反对的做法的调试信息。 // extra:附加在异常消息message后的内容。 // removal:指出会在将来什么时候移除这个做法。 var message = " DEPRECATED: " + behaviour; if (extra){message += " " + extra;} if (removal){message += " --willberemovedinversion: " + removal;} dojo.debug(message); } dojo.inherits = function ( /* Function */ subclass, /* Function */ superclass){ // 摘要:在两个类间建立继承。 if ( typeof superclass != ' function ' ){ dojo.raise( " dojo.inherits:superclassargument[ " + superclass + " ]mustbeafunction(subclass:[ " + subclass + " '] " ); } subclass.prototype = new superclass(); subclass.prototype.constructor = subclass; subclass.superclass = superclass.prototype; // 被反对的:super是一个保留字,使用'superclass' subclass[ ' super ' ] = superclass.prototype; } dojo.render = ( function (){ // TODOC:HOWTODOCTHIS? // 摘要:描述当前环境的支持、操作系统和浏览器的细节。 // TODOC:这是许多人要交互的一些东西吗?如果是,我们也许应该给出建有结构的文档... function vscaffold(prefs,names){ var tmp = { capable: false , support:{ builtin: false , plugin: false }, prefixes:prefs }; for ( var prop in names){ tmp[prop] = false ; } return tmp; } return { name: "" , ver:dojo.version, os:{win: false ,linux: false ,osx: false }, html:vscaffold([ " html " ],[ " ie " , " opera " , " khtml " , " safari " , " moz " ]), svg:vscaffold([ " svg " ],[ " corel " , " adobe " , " batik " ]), vml:vscaffold([ " vml " ],[ " ie " ]), swf:vscaffold([ " Swf " , " Flash " , " Mm " ],[ " mm " ]), swt:vscaffold([ " Swt " ],[ " ibm " ]) }; })(); // **************************************************************** // dojo.hostenvmethodsthatmustbedefinedinhostenv_*.js(dojo.hostenv的这些方法必须在hostenv_*.js被定义) // **************************************************************** /* * *TheinterfacedefininingtheinteractionwiththeEcmaScripthostenvironment. *定义ECMAScript主机环境的交互接口 */ /* *所有这些方法都不能被库的用户所直接调用。 *作为替代,应该调用如"loadModule"这样的公共方法。 */ dojo.hostenv = ( function (){ // TODOC:HOWTODOCTHIS? // 摘要:Providesencapsulationofbehaviorthatchangesacrossdifferent'hostenvironments' // 摘要:提供在不同"主机环境"(如不同的浏览器,serverviaRhino等)下,会有所变化的行为的简化信息。 // 说明:所有这写方法都不能被库的用户所直接调用。 // 调用如"loadModule"这样的公共方法。 // 默认的配置选项 var config = { isDebug: false , allowQueryConfig: false , baseScriptUri: "" , baseRelativePath: "" , libraryScriptUri: "" , iePreventClobber: false , ieClobberMinimal: true , preventBackButtonFix: true , searchIds:[], parseWidgets: true }; if ( typeof djConfig == " undefined " ){djConfig = config;} else { for ( var option in config){ if ( typeof djConfig[option] == " undefined " ){ djConfig[option] = config[option]; } } } return { name_: ' (unset) ' , version_: ' (unset) ' , getName: function (){ // 摘要:返回主机环境的名称. return this .name_; // String }, getVersion: function (){ // 摘要:返回主机环境的版本. return this .version_; // String }, getText: function ( /* String */ uri){ // 摘要:读取指定的"uri"上的纯文本内容。 // 说明: // If'getText()'isnotimplemented,thenitisnecessarytooverride // 'loadUri()'withanimplementationthatdoesn'trelyonit. // 如果"getText()"没有被实现,那就需要去除不需依赖"loadUri()"的实现。 dojo.unimplemented( ' getText ' , " uri= " + uri); } }; })(); dojo.hostenv.getBaseScriptUri = function (){ // 摘要:返回与找到其他脚本文件相联系的基本脚本文件的URI。 // TODOC:啊?我不明白这个注释。什么其他的脚本?这个文件是其他Dojo库文件的路径? // MAYBE:返回Dojo库的脚本文件的基本URI??? // 返回:空字符串或者以"/"结尾的路径。 if (djConfig.baseScriptUri.length){ return djConfig.baseScriptUri; } // MOW:为什么不这样: // uri=djConfig.libraryScriptUri||djConfig.baseRelativePath // ???而是newString(...)' var uri = new String(djConfig.libraryScriptUri || djConfig.baseRelativePath); if ( ! uri){dojo.raise( " NothingreturnedbygetLibraryScriptUri(): " + uri);} // MOW:URI好像没有被真的使用。是不是作了djConfig.baseRelativePath的硬性编码(hard-coding)...??? var lastslash = uri.lastIndexOf( ' / ' ); // MOW??? djConfig.baseScriptUri = djConfig.baseRelativePath; return djConfig.baseScriptUri; // String } 以后再补上。呵呵 (编辑:李大同) 【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容! |