Dojo学习笔记(二)（转）

parseWidgets，这个是可以控制dojo是否自动解析具有dojoType的html元素为对应的widget，如果你没有使用任何Widget，建议设置为false以加快dojo的加载速度

searchIds，这是一个字符串数组，定义了所有需要解析为widget的html元素的ID，如果ID不在其中的html元素是不会被解析的，当数组为空数组时，则所有具有dojoType的元素都会被解析

至于其它的属性，不是用处不大，就是不知道有什么作用

在实际开发中，可以把djConfig的定义放在一个js文件里，并将其作为第一个引用的js文件，这样应该是最方便的。
***********************************************************************************************************************
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);
 

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

//**********************************************************************************************************************
Dojo学习笔记(4. dojo.string & dojo.lang) 

模块：dojo.string.common / dojo.string
dojo.string.common 和 dojo.string 是一样的，只要require其中一个就可以使用以下方法
dojo.string.trim
去掉字符串的空白
Usage Example:
s = " abc ";dojo.string.trim(s);      //will return "abc"dojo.string.trim(s, 0);      //will return "abc"dojo.string.trim(s, 1);      //will return "abc "dojo.string.trim(s, -1);//will return " abc"

dojo.string.trimStart
去掉字符串开头的空白
Usage Example:
s = " abc ";dojo.string.trimStart(s);      //will return "abc "
dojo.string.trimEnd
去掉字符串结尾的空白
Usage Example:
s = " abc ";dojo.string.trimEnd(s);            //will return " abc"
dojo.string.repeat
生成由同一字符(串)重复组成的字符串
Usage Example:
dojo.string.repeat("a", 4); //will return "aaaa"dojo.string.repeat("1234", 3, "-"); //will return "1234-1234-1234"
dojo.string.pad
使用字符补齐字符串
Usage Example:
dojo.string.pad("100", 6);            //will return "000100"dojo.string.pad("100", 6, "0", 1);      //will return "000100"dojo.string.pad("100", 6, "0", -1);      //will return "100000"

dojo.string.padLeft
使用字符补齐字符串开头
Usage Example:
dojo.string.padLeft("100", 6);            //will return "100000"
dojo.string.padRight
使用字符补齐字符串结尾
Usage Example:
dojo.string.padRight("100", 6);            //will return "100000"

模块：dojo.lang.common / dojo.lang
dojo.lang.common 和 dojo.lang 是一样的，只要require其中一个就可以使用以下方法
dojo.lang.mixin
将一个对象的方法和属性增加到另一个对象上
Usage Example:

var s1 = {name: "TestObj", test1: function(){alert("this is test1!");}}var s2 = {value: 1000, test2: function(){alert("this is test2!");}}var d = {};dojo.lang.mixin(d, s1, s2); //执行后d就具备了s1和s2的所有属性和方法d.test1();
dojo.lang.extend
为指定类的原型扩展方法与属性
Usage Example:

TestClass = function() {};dojo.lang.extend(TestClass, {name: "demo", test: function(){alert("Test!");}});var o = new TestClass();  //TestClass本来是没有test方法的，但是extend以后就有test方法了o.test();
dojo.lang.find=dojo.lang.indexOf
查找指定对象在指定数组中的位置
Usage Example:
var arr = [1,2,3,3,2,1];dojo.lang.find(arr, 2);                  //will return 1dojo.lang.find(arr, 2, true);            //will return 1dojo.lang.find(arr, "2", true);            //will return -1dojo.lang.find(arr, "2", false);      //will return 1dojo.lang.find(arr, 2, true, true);      //will return 4
dojo.lang.findLast=dojo.lang.lastIndexOf
查找指定对象在指定数组中的位置，从后往前查
Usage Example:
var arr = [1,2,3,3,2,1];dojo.lang.findLast(arr, 2);                  //will return 4dojo.lang.findLast(arr, 2, true);            //will return 4dojo.lang.findLast(arr, "2", true);            //will return -1dojo.lang.findLast(arr, "2", false);            //will return 4
dojo.lang.inArray
查找指定对象是否在指定数组中
Usage Example:
var arr = [1,2,3];dojo.lang.inArray(arr, 1);      //will return truedojo.lang.inArray(arr, 4);      //will return false
dojo.lang.isObject
判断输入的类型是否为对象
Usage Example:
dojo.lang.isObject(new String());      //will return truedojo.lang.isObject("123"));      //will return false
dojo.lang.isArray
判断输入的类型是否为数组
Usage Example:
dojo.lang.isArray({a:1,b:2});      //will return falsedojo.lang.isArray([1,2,3]);      //will return true
dojo.lang.isFunction
判断输入的类型是否为函数
Usage Example:
dojo.lang.isFunction(function() {});      //will return true
dojo.lang.isString
判断输入的类型是否为字符串
Usage Example:
dojo.lang.isString("");      //will return truedojo.lang.isString(0);      //will return false
dojo.lang.isAlien
判断输入的类型是否为系统函数
Usage Example:
dojo.lang.isAlien(isNaN);      //will return true
dojo.lang.isBoolean
判断输入的类型是否为布尔类型
Usage Example:
dojo.lang.isBoolean(2>1);      //will return true
dojo.lang.isNumber
判断输入的类型是否为数值，根据注释所说，此函数使用不太可靠，但是可替换使用的系统函数isNaN也不太可靠
dojo.lang.isUndefined
判断输入是否为未定义，根据注释所说，此函数有可能会导致抛出异常，推荐使用 typeof foo == "undefined" 来判断
模块：dojo.lang.extras
dojo.lang.setTimeout
延迟指定时间后执行指定方法