dojo笔记

一、Dojo学习笔记(1.模块与包)..........................................................................................1二、Dojo学习笔记(2.djConfig解说)....................................................................................4三、Dojo学习笔记(3.Dojo的基础对象和方法)..................................................................6四、Dojo学习笔记(4.dojo.string&dojo.lang)......................................................................9五、Dojo学习笔记(5.dojo.lang.array&dojo.lang.func&dojo.string.extras)....................13六、Dojo学习笔记(6.dojo.io.IO&dojo.io.BrowserIO)......................................................18七、Dojo学习笔记(7.dojo.dom)..........................................................................................22八、Dojo学习笔记(8.dojo.event&dojo.event.topic&dojo.event.browser)......................27九、Dojo学习笔记(9.dojo.graphics.color&dojo.uri.Uri)..................................................33一、Dojo学习笔记(1.模块与包)Intro:Dojo是一个非常强大的面向对象的JavaScript的工具箱,建议读者能够去补充一下JavaScript下如何使用OO进行编程的,这对于你以后阅读DojoSource有很大的用处请大家下载dojo0.3.1,以下的说明均针对此版本翻译自:把Dojo加入到我们的Web程序中1.标志scripttype=text/javascriptdjConfig={isDebug:false};/scriptdjConfig是Dojo里的一个全局对象,其作用就是为Dojo提供各种选项,isDebug是最常用的属性之一,设置为True以便能够在页面上直接看到调试输出,当然其中还有些属性与调试有关,这里就不罗索了2.引用dojo的启动代码scripttype=text/javascriptsrc=/yourpath/dojo.js/这样你就引用了dojo的代码,并可以直接使用其中部分常用的对象,下载下来的dojo.js是压缩(removecommentsandspace)后的代码,要阅读的话,建议阅读dojo.js.uncompressed.js,dojo.js大概有127K,而未压缩前有211K,ok,为什么会这么大呢,原来其已经把部分常用的模块整合进dojo.js里,因此显得大了一点,build.txt里就说明了默认的dojo.js包含了哪些模块3.声明你所要用到的包scripttype=text/javascriptdojo.require(dojo.math);dojo.require(dojo.io.*);dojo.require(dojo.widget.*);/script你就把这些代码当成是java的import语句或C#中的using语句一样,如果你不require的话,而模块本身又没有整合在dojo.js中,是会出现脚本错误的喔2.针对不同需求提供的预整合包Dojo本身是由许多模块所组合而成的,但是由于用户需求的多样性,dojo针对不同的需求而提供了不同的版本,用户在下载dojo的时候就看见可以选择很多的版本,比如Ajax版和Widget版,每个版本最重要的区别就在于dojo.js文件,但是除此之外,每一个版本都是全功能的,dojo.js根据版本的不同而整合进了不同的模块3.直接获取Dojo的最新源代码首先你必须安装Subversion,当Subversion在你的电脑上能够正常工作后,你就可以通过如下命令下载dojo的源代码:svnco这会在你的当前目录下创建一个trunk的目录;如果你希望直接Get到当前目录,用这个命令:svnco或者你希望Get到当前目录下的MyDir目录,用这个命令:svnco模块与包模块Dojo的代码被划分为逻辑单元称之为模块,这有点类似于Java中的package,除了dojo的模块能够包含类(类似于java中的classes)和简单函数比如:模块dojo.html包含了一系列的函数,比如dojo.html.getContentBox(),模块dojo.dnd包含了一系列的HtmlDragObject的类注意名称约定,函数的首字母为小写字母,类的首字母为大写模块也可以称之为命名空间包在多数情况下,dojo的模块只需要定义在一个文件就可以了,但有时,一个模块可能划分到多个文件,比如:模块dojo.html,本来是定义在一个文件中,可是由于功能的增强,文件逐渐变大,我们不得不将其拆分为多个文件,这主要是为性能考虑,以便浏览器可以只下载其需要用到的代码,不幸的是其实现细节对于dojo的用户看起来不那么透明,你必须知道你想要用到的功能到底是包含在哪个文件,然后才能require并使用它这样的每一个文件都称之为一个包dojo.require(dojo.html.extras)将引用文件src/html/extras.js,这将定义模块dojo.html的若干(并非所有)函数据我所知,尽管单个文件可以定义包里的多个类,单个脚本文件不能定义多个模块(在Java可以等效于在一个文件中定义2个类),并且,包的名称和模块的名称可以不同,比如:包dojo.widget.Button定义了dojo.widget.html.Button基本上你应该这样认为,包和模块尽管密切相关,但是是两个完全不同的实体为什么会有模块和包这样的概念?为什么会有模块和包这样的概念?为了满足你的应用程序只需要加载其所用到的东西的需求,充分利用模块化设计的优点,dojo维护了最小的足印以便仍能提供你所需要的功能,为什么要你的用户浪费时间去下载用不到的JavaScript,当一个包就是一个js文件时,一个模块本质上就是一个命名空间,比如:dojo.style或dojo.html.extras多数简单情况下,一个包包含了一个模块,但更常见的是,一个模块可能被拆分为几个包文件利用包和模块,将能确保你能够交付最相关的功能代码,最小程度的减少代码的膨胀和消除由此带来的不好的用户体验,这就是模块设计的主要目标,通过模块化,你能够引入自定义模块(你自己拥有的JavaScript工具),并且维护模块对于核心代码库基本不会产生什么影响另外,Dojo的模块系统也提供了内建的机制来使用代码提供命名空间,比如,通过模块dojo.event定义的Dojo的事件系统怎样引用设置引用语句你怎样才能知道该引用哪个包到dojo.require()?1.模块首先,确定你要使用什么模块,这个例子我们假定你要使用dojo.lfx.html2.包搜索代码后你发现dojo.lfx.html定义在2个文件:src/lfx/html.jssrc/lfx/extras.js根据你要用到的功能,你可以dojo.require(dojo.lfx.html);或dojo.require(dojo.lfx.html);dojo.require(dojo.lfx.extras);通配符新用户可能会对dojo.lfx.*这样就可以替代上面2句而感到诧异,实际上,__package__.js中已经定义了通配符可以代替的语句,并且这样可以让dojo根据当时的环境而决定加载具体的模块tobecontinued...二、Dojo学习笔记(2.djConfig解说)djConfig是dojo内置的一个全局设置对象，其作用是可以通过其控制dojo的行为首先我们需要在引用dojo.js前声明djConfig对象，以便在加载dojo.js的时候才能够取得所设置的值，虽然在0.3版本以后dojo支持在加载后设置，但是强烈建议你把声明djConfig的代码作为第一段script一个完整的djConfig对象定义如下（值均为dojo的默认值）scripttype=text/javascriptvardjConfig={isDebug:false,debugContainerId:,bindEncoding:,allowQueryConfig:false,baseScriptUri:,parseWidgets:truesearchIds:[],baseRelativePath:,libraryScriptUri:,iePreventClobber:false,ieClobberMinimal:true,preventBackButtonFix:true,};/scriptisDebug是一个很有用的属性，顾名思义，如果设置为真，则所有dojo.Debug的输出有效，开发时应该设置为true，发布时应该设置为falsedebugContainerId同样也是与调试有关的，如果不指定的话，调试信息将会直接利用document.write输出，这样可能会破坏页面的整体布局，所以你可以指定任何一个可以作为容器的html元素的id作为调试信息输出容器allowQueryConfig，这个属性指明dojo是否允许从页面url的参数中读取djConfig中的相关属性，当值为true时，dojo会优先从url参数中读取djConfig的其他属性，比如:=divDebugbaseScriptUri，一般不需要设置，dojo会自动根据你引用dojo.js的路径设置这个值，比如，scripttype=text/javascriptsrc=../dojo/dojo.js/script，自动获取的值便是../dojo/ps:如果你有多个工程需要同时引用dojo.js的话，建议也把dojo当作一个独立的工程，引用的时候采用绝对路径就可以了parseWidgets，这个是可以控制dojo是否自动解析具有dojoType的html元素为对应的widget，如果你没有使用任何Widget，建议设置为false以加快dojo的加载速度searchIds，这是一个字符串数组，定义了所有需要解析为widget的html元素的ID，如果ID不在其中的html元素是不会被解析的，当数组为空数组时，则所有具有dojoType的元素都会被解析还有一个bindEncoding，是用来设置默认的bind请求的编码方式至于其它的属性，不是用处不大，就是不知道有什么作用在实际开发中，可以把djConfig的定义放在一个js文件里，并