Dojo-0.3.1debug版本部分翻译

前端之家收集整理的这篇文章主要介绍了Dojo-0.3.1debug版本部分翻译前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

没事的时候翻译的,当阅读做了。倒~!!

if ( typeof dojo == " undefined " ){

@H_301_26@/* @H_301_26@*
*@文件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$
@H_301_26@*/

@H_301_26@// @H_301_26@TODOC:HOWTODOCTHEBELOW? @H_301_26@
// @H_301_26@@全局:djConfig @H_301_26@
// @H_301_26@摘要: @H_301_26@
// @H_301_26@载入库时,应用程序代码可以先设置全局变量"djConfig"来取消某个Dojo运作方式的全局设定。 @H_301_26@
// @H_301_26@说明:可以设定如下全局变量: @H_301_26@
// @H_301_26@-isDebug:false @H_301_26@
// @H_301_26@-allowQueryConfig:false @H_301_26@
// @H_301_26@-baseScriptUri:"" @H_301_26@
// @H_301_26@-baseRelativePath:"" @H_301_26@
// @H_301_26@-libraryScriptUri:"" @H_301_26@
// @H_301_26@-iePreventClobber:false @H_301_26@
// @H_301_26@-ieClobberMinimal:true @H_301_26@
// @H_301_26@-preventBackButtonFix:true @H_301_26@
// @H_301_26@-searchIds:[] @H_301_26@
// @H_301_26@-parseWidgets:true @H_301_26@
// @H_301_26@TODOC:HOWTODOCTHESEVARIABLES? @H_301_26@
// @H_301_26@TODOC:ISTHISACOMPLETELIST? @H_301_26@
// @H_301_26@注意: @H_301_26@
// @H_301_26@在有"dojo.*"时,"djConfig"不存在。因此,在"dojo"变量存在前可以被设定。 @H_301_26@
// @H_301_26@注意: @H_301_26@
// @H_301_26@在载入库之后设定这些变量,都不起任何作用。 @H_301_26@
// @H_301_26@TODOC:现在仍然如此吗?版本0.3的发行说明指出载入后仍可设定。. @H_301_26@
//



@H_301_26@// @H_301_26@TODOC:HOWTODOCTHIS? @H_301_26@
// @H_301_26@@全局:dj_global @H_301_26@
// @H_301_26@摘要: @H_301_26@
// @H_301_26@主环境的顶层全局对象的别名 @H_301_26@
// @H_301_26@(例如:浏览器的window对象)。 @H_301_26@
// @H_301_26@说明: @H_301_26@
// @H_301_26@使用"dj_global"而不是window对象,是为了保证你的代码在上下文中可以正确运行,而不是指哪些浏览器。(eg:Rhinoonaserver). @H_301_26@
var dj_global = this ;



function dj_undef( @H_301_26@/* @H_301_26@String @H_301_26@*/ name, @H_301_26@/* @H_301_26@Object? @H_301_26@*/ object){
@H_301_26@// @H_301_26@摘要:如果在"object"对象上定义了为参数"name"的属性,返回false(或者在全局范围,"object"对象为null)。 @H_301_26@
@H_301_26@// @H_301_26@说明:注意定义和存在是两个不同的概念。 @H_301_26@
if (object == null ){object = dj_global;}
@H_301_26@// @H_301_26@如果object不是一个对象时发生异常。 @H_301_26@
return ( typeof object[name] == " undefined " ); @H_301_26@// @H_301_26@Boolean @H_301_26@
}


@H_301_26@// @H_301_26@确保定义了djConfig @H_301_26@
if (dj_undef( " djConfig " )){
var djConfig = {};
}


@H_301_26@// @H_301_26@TODOC:HOWTODOCTHIS? @H_301_26@
// @H_301_26@dojo是我们使用库中几乎所有公共标志的根变量——确保定义 @H_301_26@
if (dj_undef( " dojo " )){
var dojo = {};
}

@H_301_26@// @H_301_26@TODOC:HOWTODOCTHIS? @H_301_26@
dojo.version = {
@H_301_26@// @H_301_26@摘要:当前dojo实例的版本号。 @H_301_26@
major: 0 ,minor: 3 ,patch: 1 ,flag: "" ,
revision:Number(
" $Rev:4342$ " .match( / [ 0 - 9 ] +/ )[ 0 ]), @H_301_26@// @H_301_26@找到字符串中的数字匹配返回的字符串数组的第1个元素,并转化成数值类型 @H_301_26@
toString: function (){
with (dojo.version){
return major + " . " + minor + " . " + patch + flag + " ( " + revision + " ) " ; @H_301_26@// @H_301_26@String @H_301_26@
}
}
}

dojo.evalProp
= function ( @H_301_26@/* @H_301_26@String @H_301_26@*/ name, @H_301_26@/* @H_301_26@Object @H_301_26@*/ object, @H_301_26@/* @H_301_26@Boolean? @H_301_26@*/ create){
@H_301_26@// @H_301_26@摘要:返回"object[name]".如果没有定义并且"create"为true,会返回一个新对象。 @H_301_26@
@H_301_26@// @H_301_26@说明: @H_301_26@
@H_301_26@// @H_301_26@如果没有定义"object[name]"并且"create"不为true,返回null。 @H_301_26@
@H_301_26@// @H_301_26@注意:定义和存在是两个不同的概念。 @H_301_26@
@H_301_26@// @H_301_26@注意:对象的属性也是对象。 @H_301_26@
return (object && ! dj_undef(name,object) ? object[name]:(create ? (object[name] = {}):undefined)); @H_301_26@// @H_301_26@mixed @H_301_26@
}


dojo.parSEObjPath
= function ( @H_301_26@/* @H_301_26@String @H_301_26@*/ path, @H_301_26@/* @H_301_26@Object? @H_301_26@*/ context, @H_301_26@/* @H_301_26@Boolean? @H_301_26@*/ create){
@H_301_26@// @H_301_26@摘要:解析字符串path并成返回一个对象,它带有对应的对象引用及属性名称。 @H_301_26@
@H_301_26@// @H_301_26@说明: @H_301_26@
@H_301_26@// @H_301_26@返回一个带有"obj"和"prop"两个属性的对象。 @H_301_26@
@H_301_26@// @H_301_26@参照"path"指出"obj[prop]"。 @H_301_26@
@H_301_26@// @H_301_26@path:一个对象的Path是以"A.B.C"的形式。 @H_301_26@
@H_301_26@// @H_301_26@context:作用类似根目录的对象,默认是"dj_global"。 @H_301_26@
@H_301_26@// @H_301_26@create:如果为true,就会沿"path",为那些没有定义的点创建一些新对象。 @H_301_26@
var object = (context != null ? context:dj_global);
var names = path.split( ' . ' );
var prop = names.pop(); @H_301_26@// @H_301_26@弹出数组的最后一个元素并返回,并将数组长度减1。 @H_301_26@
for ( var i = 0 ,l = names.length;i < l && object;i ++ ){
object
= dojo.evalProp(names[i],object,create);
}
return {obj:object,prop:prop}; @H_301_26@// @H_301_26@Object:{obj:Object,prop:String} @H_301_26@
}


dojo.evalObjPath
= function ( @H_301_26@/* @H_301_26@String @H_301_26@*/ path, @H_301_26@/* @H_301_26@Boolean? @H_301_26@*/ create){
@H_301_26@// @H_301_26@摘要:Returnthevalueofobjectat'path'intheglobalscope,withoutusing'eval()'. @H_301_26@
@H_301_26@// @H_301_26@摘要:返回全局范围内在"path"上的对象的值,没有使用"eval()"。 @H_301_26@
@H_301_26@// @H_301_26@path:一个对象的Path是以"A.B.C"的形式。 @H_301_26@
@H_301_26@// @H_301_26@create:如果为true,就会沿"path",为那些没有定义的点创建一些新对象。 @H_301_26@
if ( typeof path != " string " ){
return dj_global;
}
@H_301_26@// @H_301_26@没有句点号的快速路径 @H_301_26@
if (path.indexOf( ' . ' ) == - 1 ){
return dojo.evalProp(path,dj_global,create); @H_301_26@// @H_301_26@mixed @H_301_26@
}

@H_301_26@// @H_301_26@MOW:过去的"with"句法有些混乱。并且,如果parSEObjPath返回了null,还会抛出一个错误。 @H_301_26@
var ref = dojo.parSEObjPath(path,create);
if (ref){
return dojo.evalProp(ref.prop,ref.obj,create); @H_301_26@// @H_301_26@mixed @H_301_26@
}
return null ;
}

@H_301_26@// @H_301_26@**************************************************************** @H_301_26@
// @H_301_26@globalpublicutils(全局公有调用) @H_301_26@
// @H_301_26@TODOC:DOWEWANTTONOTETHATTHESEAREGLOBALPUBLICUTILS?(我们需要记住这些是公有调用吗?) @H_301_26@
// @H_301_26@**************************************************************** @H_301_26@

dojo.errorToString
= function ( @H_301_26@/* @H_301_26@Error @H_301_26@*/ exception){
@H_301_26@// @H_301_26@摘要:返回异常的'message','note'ortext. @H_301_26@
@H_301_26@// @H_301_26@TODO:如果没有Error.prototype.toString将不能实现吗? @H_301_26@
@H_301_26@// @H_301_26@...因为这是生来造成的错误,所以对象不就总是招来这些事吗? @H_301_26@
if ( ! dj_undef( " message " ,exception)){
return exception.message; @H_301_26@// @H_301_26@String @H_301_26@
} else if ( ! dj_undef( " note " ,exception)){
return exception.note; @H_301_26@// @H_301_26@String @H_301_26@
} else {
return exception; @H_301_26@// @H_301_26@Error @H_301_26@
}
}


dojo.raise
= function ( @H_301_26@/* @H_301_26@String @H_301_26@*/ message, @H_301_26@/* @H_301_26@Error? @H_301_26@*/ exception){
@H_301_26@// @H_301_26@摘要:抛出一个错误消息。如果被支持,还在文字的后面附加上"exception"的内容。 @H_301_26@
@H_301_26@// @H_301_26@注意:还会使用"dojo.hostenv.println"向用户打出消息的内容。 @H_301_26@
if (exception){
message
= message + " : " + dojo.errorToString(exception);
}

@H_301_26@// @H_301_26@如果使用"dojo.hostenv.println",能向用户打出消息。 @H_301_26@
try {dojo.hostenv.println( " FATAL: " + message);} catch (e){}

throw Error(message);
}

@H_301_26@// @H_301_26@已经废除的一些方法,所以不起作用了 @H_301_26@
// @H_301_26@TODOC:HOWTODOCTHESE? @H_301_26@
dojo.debug = function (){}
dojo.debugShallow
= function (obj){}
dojo.profile
= {start: function (){},end: function (){},stop: function (){},dump: function (){}};


function dj_eval( @H_301_26@/* @H_301_26@String @H_301_26@*/ scriptFragment){
@H_301_26@// @H_301_26@摘要:使用全局范围内的评估方法。这没有直接调用"eval()"。 @H_301_26@
@H_301_26@// @H_301_26@说明:放在一个单独的方法里,减小评估上下文的大小。 @H_301_26@
@H_301_26@// @H_301_26@注意: @H_301_26@
@H_301_26@// @H_301_26@-JSCeval()给出了可选的第二个参数,可以取"unsafe"。 @H_301_26@
@H_301_26@// @H_301_26@-Mozilla/SpiderMonkeyeval()给出了一个可选的第二个参数,作为新代码符号所属的特定范围的对象。 @H_301_26@
return dj_global.eval ? dj_global.eval(scriptFragment):eval(scriptFragment); @H_301_26@// @H_301_26@mixed @H_301_26@
}



dojo.unimplemented
= function ( @H_301_26@/* @H_301_26@String @H_301_26@*/ funcname, @H_301_26@/* @H_301_26@String? @H_301_26@*/ extra){
@H_301_26@// @H_301_26@摘要:抛出由于某个方法没有实现而产生的异常 @H_301_26@
@H_301_26@// @H_301_26@extra:附加在异常消息message后的内容。 @H_301_26@
var message = " ' " + funcname + " 'notimplemented " ;
if (extra != null ){message += " " + extra;}
dojo.raise(message);
}


dojo.deprecated
= function ( @H_301_26@/* @H_301_26@String @H_301_26@*/ behavIoUr, @H_301_26@/* @H_301_26@String? @H_301_26@*/ extra, @H_301_26@/* @H_301_26@String? @H_301_26@*/ removal){
@H_301_26@// @H_301_26@摘要:记录指出一个已经被反对的做法的调试信息。 @H_301_26@
@H_301_26@// @H_301_26@extra:附加在异常消息message后的内容。 @H_301_26@
@H_301_26@// @H_301_26@removal:指出会在将来什么时候移除这个做法。 @H_301_26@
var message = " DEPRECATED: " + behavIoUr;
if (extra){message += " " + extra;}
if (removal){message += " --willberemovedinversion: " + removal;}
dojo.debug(message);
}



dojo.inherits
= function ( @H_301_26@/* @H_301_26@Function @H_301_26@*/ subclass, @H_301_26@/* @H_301_26@Function @H_301_26@*/ superclass){
@H_301_26@// @H_301_26@摘要:在两个类间建立继承。 @H_301_26@
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;
@H_301_26@// @H_301_26@被反对的:super是一个保留字,使用'superclass' @H_301_26@
subclass[ ' super ' ] = superclass.prototype;
}

dojo.render
= ( function (){
@H_301_26@// @H_301_26@TODOC:HOWTODOCTHIS? @H_301_26@
@H_301_26@// @H_301_26@摘要:描述当前环境的支持、操作系统和浏览器的细节。 @H_301_26@
@H_301_26@// @H_301_26@TODOC:这是许多人要交互的一些东西吗?如果是,我们也许应该给出建有结构的文档... @H_301_26@
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 " ])
};
})();

@H_301_26@// @H_301_26@**************************************************************** @H_301_26@
// @H_301_26@dojo.hostenvmethodsthatmustbedefinedinhostenv_*.js(dojo.hostenv的这些方法必须在hostenv_*.js被定义) @H_301_26@
// @H_301_26@**************************************************************** @H_301_26@

@H_301_26@/* @H_301_26@*
*TheinterfacedefininingtheinteractionwiththeEcmaScripthostenvironment.
*定义ECMAScript主机环境的交互接口
@H_301_26@*/

@H_301_26@/* @H_301_26@
*所有这些方法都不能被库的用户所直接调用
*作为替代,应该调用如"loadModule"这样的公共方法
@H_301_26@*/
dojo.hostenv
= ( function (){
@H_301_26@// @H_301_26@TODOC:HOWTODOCTHIS? @H_301_26@
@H_301_26@// @H_301_26@摘要:Providesencapsulationofbehaviorthatchangesacrossdifferent'hostenvironments' @H_301_26@
@H_301_26@// @H_301_26@摘要:提供在不同"主机环境"(如不同的浏览器,serverviaRhino等)下,会有所变化的行为的简化信息。 @H_301_26@
@H_301_26@// @H_301_26@说明:所有这写方法都不能被库的用户所直接调用。 @H_301_26@
@H_301_26@// @H_301_26@调用如"loadModule"这样的公共方法。 @H_301_26@

@H_301_26@// @H_301_26@默认的配置选项 @H_301_26@
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 (){
@H_301_26@// @H_301_26@摘要:返回主机环境的名称. @H_301_26@
return this .name_; @H_301_26@// @H_301_26@String @H_301_26@
},


getVersion:
function (){
@H_301_26@// @H_301_26@摘要:返回主机环境的版本. @H_301_26@
return this .version_; @H_301_26@// @H_301_26@String @H_301_26@
},

getText:
function ( @H_301_26@/* @H_301_26@String @H_301_26@*/ uri){
@H_301_26@// @H_301_26@摘要:读取指定的"uri"上的纯文本内容。 @H_301_26@
@H_301_26@// @H_301_26@说明: @H_301_26@
@H_301_26@// @H_301_26@If'getText()'isnotimplemented,thenitisnecessarytooverride @H_301_26@
@H_301_26@// @H_301_26@'loadUri()'withanimplementationthatdoesn'trelyonit. @H_301_26@
@H_301_26@// @H_301_26@如果"getText()"没有被实现,那就需要去除不需依赖"loadUri()"的实现。 @H_301_26@

dojo.unimplemented(
' getText ' , " uri= " + uri);
}
};
})();


dojo.hostenv.getBaseScriptUri
= function (){
@H_301_26@// @H_301_26@摘要:返回与找到其他脚本文件相联系的基本脚本文件的URI。 @H_301_26@
@H_301_26@// @H_301_26@TODOC:啊?我不明白这个注释。什么其他的脚本?这个文件是其他Dojo库文件的路径? @H_301_26@
@H_301_26@// @H_301_26@MAYBE:返回Dojo库的脚本文件的基本URI??? @H_301_26@
@H_301_26@// @H_301_26@返回:空字符串或者以"/"结尾的路径。 @H_301_26@
if (djConfig.baseScriptUri.length){
return djConfig.baseScriptUri;
}

@H_301_26@// @H_301_26@MOW:为什么不这样: @H_301_26@
@H_301_26@// @H_301_26@uri=djConfig.libraryScriptUri||djConfig.baseRelativePath @H_301_26@
@H_301_26@// @H_301_26@???而是newString(...)' @H_301_26@
var uri = new String(djConfig.libraryScriptUri || djConfig.baseRelativePath);
if ( ! uri){dojo.raise( " NothingreturnedbygetLibraryScriptUri(): " + uri);}

@H_301_26@// @H_301_26@MOW:URI好像没有被真的使用。是不是作了djConfig.baseRelativePath的硬性编码(hard-coding)...??? @H_301_26@
var lastslash = uri.lastIndexOf( ' / ' ); @H_301_26@// @H_301_26@MOW??? @H_301_26@
djConfig.baseScriptUri = djConfig.baseRelativePath;
return djConfig.baseScriptUri; @H_301_26@// @H_301_26@String @H_301_26@
}

以后再补上。呵呵

猜你在找的Dojo相关文章