这里所说的基础对象和方法是指的不
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);
以上全部是自己阅读源代码写的总结,如有错误,还请指明。
匿名函数
在开始前,我想介绍一下 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);
以上全部是自己阅读源代码写的总结,如有错误,还请指明。