Dojo学习笔记(3. Dojo的基础对象和方法)

Dojo学习笔记(3. 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("打印失败", new Error("文件不存在"));
 }
 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说明浏览器是Internet Explorer
dojo.html.opera             返回true说明浏览器是Opera
dojo.html.khtml             返回true说明浏览器是Konqueror
dojo.html.safari      返回true说明浏览器是Safari
dojo.html.moz        返回true说明浏览器是Mozilla FireFox
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说明浏览器是IE 5.0
dojo.html.ie55         返回true说明浏览器是IE 5.5
dojo.html.ie60         返回true说明浏览器是IE 6.0
dojo.html.ie70         返回true说明浏览器是IE 7.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"); //will return true

 

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);

 

以上全部是自己阅读源代码写的总结，如有错误，还请指明。