dojo对象方法

这里所说的基础对象和方法是指的不Require任何包就能够调用的对象和方法

匿名函数

在开始前，我想介绍一下js里的匿名函数，这个在阅读dojo的源代码的时候，会发现到处都有匿名函数

;(function(){ alert(123); })(); //前面的分号是一个空语句，是可以不要的

匿名函数。一个匿名函数就是一个没有名字的函数。

你可以认为他们是一次性函数。当你只需要用一次某个函数时，他们就特别有用。通过使用匿名函数，没有必要把函数一直放在内存中，所以使用匿名函数更加有效率。

当然你也可以根本不定义函数，但是使用匿名函数可以把你的代码分段，就像C#中的#region一样

dojo.byId

非常有用的一个方法，与prototype.js的著名的$一样

似乎以前的版本还有dojo.byIdArray, 不过最新的版本已经找不到这个函数了(除了src\compat\0.2.2.js)

如果有多个元素具有指定的id，则返回的是一个集合

Usage Example:

dojo.byId("divTest"); dojo.byId("divTest",document); dojo.byId(document.getElementById("divTest"));

dojo.version

dojo的版本，可以取得major, minor, patch, flag和revision

这个对象没什么太大用处，除非你要根据dojo的版本选择执行你的代码

dojo.raise

抛出一个异常

dojo.errorToString

将异常转换为字符串

Usage Example:

try { dojo.raise("打印失败",newError("文件不存在")); } catch(e) { alert(dojo.errorToString(e)); }

dojo.render

系统环境对象

dojo.render.name返回browser，说明是工作在浏览器下 dojo.render.ver返回4，似乎没什么用 dojo.os.win返回true说明操作系统是Windows dojo.os.linux返回true说明操作系统是Linux dojo.os.osx返回true说明操作系统是MacOS dojo.html.ie返回true说明浏览器是InternetExplorer dojo.html.opera返回true说明浏览器是Opera dojo.html.khtml返回true说明浏览器是Konqueror dojo.html.safari返回true说明浏览器是Safari dojo.html.moz返回true说明浏览器是MozillaFireFox dojo.svg.capable 返回true说明浏览器支持svg dojo.vml.capable 返回true说明浏览器支持vml dojo.swf.capable 返回true说明浏览器支持swf dojo.swt.capable 返回true说明浏览器支持swt (IBM开发的Standard Widget Toolkit)

如果dojo.html.ie为true的话

dojo.html.ie50返回true说明浏览器是IE5.0 dojo.html.ie55返回true说明浏览器是IE5.5 dojo.html.ie60返回true说明浏览器是IE6.0 dojo.html.ie70返回true说明浏览器是IE7.0

dojo.addOnLoad

可以加载指定函数到window.load时执行，好处就是可以很方便的在window.load时执行多个函数

Usage Example:

dojo.addOnLoad(init);//init是一个函数 dojo.addOnLoad(myObject,init);//init是myObject对象的一个方法

dojo.require

如果你想调用一个模块的对象的时候，你应该首先用dojo.require来请求这个模块，dojo会根据你的请求自动取得相应的js文件，并加载到内存中，这样你才能调用或创建其中的对象

dojo会自动维护已加载的模块列表，所以是不会重复加载模块的

Usage Example:

dojo.require("dojo.event");

dojo.requireIf=dojo.requireAfterIf

可以根据指定的条件来决定是否加载指定的模块

Usage Example:

dojo.requireIf(dojo.html.ie,"dojo.html");//如果dojo.html.ie为true，才会加载dojo.html模块

dojo.provide

除非你要开发自己的模块，不然是用不到这个方法的，你可以这句看成是向系统注册这个模块名称

Usage Example:

dojo.provide("dojo.custom");

dojo.exists

判断指定对象是否具有指定名称的方法

Usage Example:

dojo.exists(dojo,"exists");//willreturntrue

dojo.hostenv.getText

返回指定url的内容

PS: 由于浏览器的安全限制，因此只能用于取得同域名的url的内容，否则会报告权限不够

Usage Example:

aSync=false;//同步，确保返回内容不为null silent=true;//不抛出错误 s=dojo.hostenv.getText("http://www.google.com/",aSync,silent);//返回Google的首页的HTML alert(s);

dojo.debug

输出调试信息，如果在djConfig中指定了debugContainerId，则输出到指定的console容器中，否则直接document.write

所有的调试信息均以 DEBUG: 开头

Usage Example:

dojo.debug("这是调试信息");

dojo.hostenv.println

与dojo.debug类似，不同的是，输出内容没有 DEBUG:

Usage Example:

dojo.hostenv.println("这是一般的输出信息");

dojo.debugShallow

输出指定对象的全部信息(Shallow说明并不会遍历到下一级别的对象属性)以供调试

Usage Example:

dojo.debugShallow(dojo.render.html);