匿名函数

在开始前，我想介绍一下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.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);

以较为复杂的DropdownDatePicker为例，首先在页面中require进来这个组件：
<script type="text/javascript">
<!--
dojo.require("dojo.widget.DropdownDatePicker");
//-->
</script>
然后在页面中加入：
<div inputName="startDate" dojoType="dropdowndatepicker" dateFormat="%Y-%m-%d" weekStartsOn="1" adjustWeeks="true"/>
或
<div inputName="endDate" dojoType="dropdowndatepicker" dateFormat="%Y-%m-%d" weekStartsOn="1" adjustWeeks="true"/>
Dojo就会自动生成两个日历组件，一个用来选择开始日期，一个用来选择结束日期。

其 中的属性dojoType指明widget的类型（全部小写就可以了）。inputName就是生成的input字段的name，提交时候作为表单的一个 参数。dateFormat是日期的格式。weekStartsOn是日历中显示的一周以哪一天开始，这里是以周一开始（0-6，0代表周日）。 adjustWeeks指明是否需要根据每个月的实际天数来调整日历中每月显示的天数（如果不调整，每个月除了自己的天数，还会多出一些相邻月份的天数， 总的天数固定为42天）。
如果需要给日期设置一个初始值，可以添加value属性，例如value="2006-10-25"。

以下的例子将组件的setDate事件（就是组件的setDate方法被调用）与外部某个回调函数关联起来：
html这样声明：
<div id="foo" inputName="startDate" dojoType="dropdowndatepicker" dateFormat="%Y-%m-%d" weekStartsOn="1" adjustWeeks="true"/>

Javas cript这样写：
<script type="text/javas cript">
<!--
function test(rfcDate){
  alert(rfcDate);
}
dojo.event.connect( dojo.widget.byId("foo").datePicker, "setDate", test);
//-->
</script>
当选择了日期，要将日期设置到input字段中时，会调用test回调函数。

DatePicker组件的用法类似，DropdownDatePicker实际上是对DatePicker组件所做的一个封装，更适合使用在表单输入的环境中。

dojo.dom.isNode

测试指定对象是否为节点

Usage Example:

dojo.dom.getUniqueId

取得唯一id

Usage Example:

dojo.dom.firstElement = dojo.dom.getFirstChildElement

取得指定节点下的第一个满足指定Tag条件的子节点

Usage Example:

dojo.dom.lastElement = dojo.dom.getLastChildElement

取得指定节点下的最后一个满足指定Tag条件的子节点

Usage Example:

dojo.dom.nextElement = dojo.dom.getNextSiblingElement

取得指定节点的下一个满足指定Tag条件的子节点

Usage Example:

dojo.dom.prevElement = dojo.dom.getPreviousSiblingElement

取得指定节点的前一个满足指定Tag条件的子节点

Usage Example:

dojo.dom.moveChildren

把指定节点下的所有子节点移动到目标节点下，并返回移动的节点数

Usage Example:

dojo.dom.copyChildren

dojo.dom.prevElement(node, 'SPAN');

把指定节点下的所有子节点复制到目标节点下，并返回复制的节点数

Usage Example:

dojo.dom.prevElement = dojo.dom.getPreviousSiblingElement

取得指定节点的前一个满足指定Tag条件的子节点

Usage Example:

dojo.dom.removeChildren

删除指定节点下的所有子节点，并返回删除的节点数

Usage Example:

dojo.dom.replaceChildren

用指定的新节点替换父节点下的所有子节点

Usage Example:

dojo.dom.removeNode

删除指定的节点

Usage Example:

dojo.dom.getAncestors

返回指定节点的父节点集合

Usage Example:

dojo.dom.getAncestorsByTag

返回所有符合指定Tag的指定节点的父节点集合

Usage Example:

返回最近的一个符合指定Tag的指定节点的父节点

Usage Example:

判断指定的节点是否为另一个节点的子孙

Usage Example:

返回指定节点的XML

Usage Example:

创建一个空的文档对象

Usage Example:

根据文字创建一个文档对象

Usage Example:

将指定的节点插入到父节点的最前面

Usage Example:

将指定的节点插入到参考节点的前面

Usage Example:

将指定的节点插入到参考节点的后面

Usage Example:

将指定的节点插入到参考节点的指定位置

Usage Example:

dojo.dom.insertAtIndex

将指定的节点插入到参考节点的子节点中的指定索引的位置

Usage Example:

dojo.dom.textContent设置或获取指定节点的文本

Usage Example:

dojo.dom.hasParent

判断指定节点是否有父节点

Usage Example:

dojo.dom.isTag

判断节点是否具有指定的tag

Usage Example: