转载请注明出处
http://www.fyting.com,谢谢
2006年初,dojo还是0.22的时候就很关注它的发展,可一直没有在实际项目中使用。一来是由于文档的缺少,而来是dojo的相关介绍总是让人望而生畏。到现在都如此,第一个hello world就搞了一大堆东西,比如widget组件,
自定义的script
标签等,
加上要引入什么css
文件,djConfig、 dojo.require等等,让人很迷惑,这么复杂,到底dojo该怎么使用呢?我只是想把dojo当作一个普通的js类库,就像prototype那样?OK,闲话少说,来看看如何使用dojo。
第一步,引入dojo.js
dojo的发行包里有4个子目录,要引入的
文件是名叫"dojo"的子目录里的dojo.js。
假设你是这样的目录结构:
引用
project
|
+--dojo-lib
| |
| +--dijit
| +--dojo
| +--dojox
| +--util
|
+--dojo_hello_world.html
- <scripttype="text/javascript"src="./dojo-lib/dojo/dojo.js"></script>
<script type="text/javascript" src="./dojo-lib/dojo/dojo.js"></script>
开始使用dojo
现在开始使用dojo的第一个
函数:dojo.byId
dojo.byId就等同于常用的document.getElement
<input type="text" name="username" id="username" value="Mark" />
<script type="text/javascript">
var username = dojo.byId('username').value
alert(username);
</script>
OK,是不是和普通的js库一样,没有任何玄机?
dojo.addOnLoad
现在我们想在window.onload里面处理一点东西,就像Ext.onReady,这个东西在dojo里叫做dojo.addOnLoad
- dojo.addOnLoad(function(){
- varusername=dojo.byId('username').value
- alert(username);
- });
dojo.addOnLoad(function(){
var username = dojo.byId('username').value
alert(username);
});
dojo.connect
OK,window.onload搞定了,那么如何监听普通的dom事件呢?没问题,强大的dojo.connect出场
- <scripttype="text/javascript">
- functionsayHello(event)
- {
- alert("Hello");
- }
- dojo.addOnLoad(function(){
- varbtn=dojo.byId('hello');
- dojo.connect(btn,"onclick",sayHello);
- });
- </script>
- <inputtype="button"id="hello"value="Hello"/>
<script type="text/javascript">
function sayHello(event)
{
alert("Hello");
}
dojo.addOnLoad(function(){
var btn = dojo.byId('hello');
dojo.connect(btn,"onclick",sayHello);
});
</script>
<input type="button" id="hello" value="Hello" />
是不是和prototype的Event.observe($('btnAdd'),"load",doAdd)差不多?
用prototype时最烦的就是那个长长的bindAsListener了,使用dojo.conncect,可以在第三个参数中指定当前的scope:
- varname="Mark"
- functionsayHello()
- {
- alert("Hello"+this.name);
- }
- varobj={
- name:"Karl"
- }
- dojo.addOnLoad(function(){
- varbtn=dojo.byId('hello');
- dojo.connect(btn,obj,sayHello);
- });
var name = "Mark"
function sayHello()
{
alert("Hello " + this.name);
}
var obj = {
name: "Karl"
}
dojo.addOnLoad(function(){
var btn = dojo.byId('hello');
dojo.connect(btn,sayHello);//注意这行的第三个和第四个参数
});
OK,点击按钮,将
输出:Hello Karl
这里dojo.connect的第三个参数变成了scope,而handler
函数是第四个,实际上
dojo.connect(btn,sayHello);
与
dojo.connect(btn,null,sayHello);
相同。
更加复杂的
用法这里不作介绍,写太多就越搞越复杂了,后面再写
文章详细介绍dojo.connect,这里只简单介绍如何绑定DOM事件。
xmlhttp dojo.xhrGet
OK,介绍了简单的DOM操作
方法,接下来该到Ajax的传统项目-XmlHttp了
在使用xmlhttp时,需要注意到编码的问题,要让dojo默认绑定为utf-8怎么办呢?很简单,只需要
修改一下引入dojo.js时的
标签:
- <scripttype="text/javascript"src="./dojo-lib/dojo/dojo.js"djConfig="isDebug:true,bindEncoding:'UTF-8'"></script>
<script type="text/javascript" src="./dojo-lib/dojo/dojo.js" djConfig="isDebug:true,bindEncoding:'UTF-8'"></script>
多了一个djConfig
属性,很简单,第一个isDebug是说是否打开FireBug的Console,第二个是xmlhttp使用的编码。第二个才是重点,设置了就一劳永逸了。
这次我们要点击了hello按钮后发出一个xmlhttp请求:
- functionsayHello(){
- dojo.xhrGet({
- url:"http://localhost/hello/sayHello.jsp",
- handleAs:"text",
- load:function(responseText)
- {
- alert(responseText);
- dojo.byId("divHello").innerHTML=responseText;
- },
- error:function(response)
- {
- alert("Error");
- }
- });
- }
- dojo.connect(btn,sayHello);
function sayHello() {
dojo.xhrGet({
url: "http://localhost/hello/sayHello.jsp",handleAs: "text",load: function(responseText)
{
alert(responseText);
dojo.byId("divHello").innerHTML = responseText;
},error: function(response)
{
alert("Error");
}
});
}
dojo.connect(btn,sayHello);
看看,够不够一目了然?
url 就是url……
handleAs 把
获取的
内容作为text/html
load 成功时的回调
函数
error 失败时的回调
函数
那如果要传入参数怎么办?
- varparams={
- username:'Mark',
- id:'105'
- }
- dojo.xhrGet({
- url:"http://localhost/hello/sayHello.jsp",
- content:params,
-
- });
var params = {
username:'Mark',id:'105'
}
dojo.xhrGet({
url: "http://localhost/hello/sayHello.jsp",content:params,//...
});
注意那个content参数,你要传入的参数是个关联数组/object,dojo会
自动把参数解析出来,要使用post
方法?
dojo.xhrGet ---> dojo.xhrPost
其他的还有
dojo.xhrPut
dojo.xhrDelete
json
那要是我想更换
获取到的数据类型,比如json?xml?
修改handleAs即可,如:
handleAs: "json"
- dojo.xhrGet({
- url:"http://localhost/hello/sayHello.jsp",
- handleAs:"json",
- load:function(json)
- {
- alert(json.name)
- }
-
- });
dojo.xhrGet({
url: "http://localhost/hello/sayHello.jsp",handleAs: "json",load: function(json)
{
alert(json.name)
}
//...
});
引用
handleAs: "json-comment-filtered" 使用注释符号/**/把json数据包含起来,推荐使用
handleAs: "json-comment-optional" 首先尝试使用json-comment-filtered,如果执行
错误,再使用普通的json格式解析
handleAs: "javascript" dojo尝试把服务器返回的数据当作javascript执行,并把结果作为参数传递给load
函数
handleAs: "xml" xml对象。注意在Mozilla和IE中的xml是不同的,推荐使用
sarissa
至于json和object的转换等,在http://dojotoolkit.org/book/dojo-book-0-9/part-3- programmatic-dijit-and-dojo/other-miscellaneous-function/converting-json 有一个表格,应该能找到你需要的。
想要直接提交一个表单,就这样:
dojo.xhrGet({
url: "http://localhost/hello/sayHello.jsp",form: dojo.byId("form1")
//...
});
要
解决IE下那个臭名昭著的缓存问题,就这样,preventCache会帮你
自动生成一个timestamp
dojo.xhrGet({
url: "http://localhost/hello/sayHello.jsp",preventCache: true
//...
});
dojo.hitch scope/context
既然用到了xmlhttp,一个常见的问题就是回调
函数的scope/context。在prototype、mootools里我们常用Function.bind,在dojo中,做相同事情的东西叫做dojo.hitch
- varhandler={
- name:'Mark',
- execute1:function(){
- dojo.xhrGet({
- url:"http://localhost/hello/sayHello.jsp",
- error:function(text)
- {
- console.dir(this);
- alert(this.name);
- }
-
- });
- },
- load:function(text){
- alert(this.name);
- },
- execute2:function(){
- dojo.xhrGet({
- url:"http://localhost/hello/sayHello.jsp",
- error:dojo.hitch(this,"load")
-
-
- });
- }
- }
var handler = {
name:'Mark',execute1: function(){
dojo.xhrGet({
url: "http://localhost/hello/sayHello.jsp",error: function(text)
{
console.dir(this);
alert(this.name);//输出undefined,这里的this表示当前io参数
}
//...
});
},load: function(text){
alert(this.name);
},execute2: function(){
dojo.xhrGet({
url: "http://localhost/hello/sayHello.jsp",error: dojo.hitch(this,"load") //输出Mark
//error: dojo.hitch(this,this.load); //与上一句相同,知道为什么要用方法名字而不是引用了吧?省去了长长的一串this.xxx
//...
});
}
}
OK,基本的东西
解决了,还有很多常用的
函数没有介绍,比如:dojo.query,dojo.forEach,dojo.margin
Box,dojo.content
Box等等
这个就没事翻翻dojo.js.uncompressed.js源
代码,dojo的文档是没啥好指望的了。
面向对象,定义Class
下一步我们看看dojo里如何定义Class:
- dojo.declare("Customer",null,{
- constructor:function(name){
- this.name=name;
- },
- say:function(){
- alert("Hello"+this.name);
- },
- getDiscount:function(){
- alert("Discountis1.0");
- }
- });
-
- varcustomer1=newCustomer("Mark");
- customer1.say();
dojo.declare("Customer",{
constructor:function(name){
this.name = name;
},say:function(){
alert("Hello " + this.name);
},getDiscount:function(){
alert("Discount is 1.0");
}
});
var customer1 = new Customer("Mark");
customer1.say();
declare有三个参数:
第一个 class名字
第二个
父类的引用
第三个 ...
构造函数的名字就叫做"construnctor"
再来看看如何继承:
- dojo.declare("VIP",Customer,{
- getDiscount:function(){
- alert("Discountis0.8");
- }
- });
- varvip=newVIP("Mark");
- vip.say();
- vip.getDiscount();
dojo.declare("VIP",{
getDiscount:function(){
alert("Discount is 0.8");
}
});
var vip = new VIP("Mark");
vip.say();
vip.getDiscount();
那么,如何
调用父类的方法呢。使用this.inherited
方法
dojo.declare("VIP",{
getDiscount:function(){
this.inherited(arguments);
//this.inherited("getDiscount",arguments);
}
});
关于构造函数:
父类构造
函数总是被
自动调用的,所以看下面的例子:
dojo.declare("Customer",{
constructor:function(name){
this.name = name;
alert("base class");
},say:function(){
alert(this.name);
}
});
dojo.declare("VIP",{
constructor:function(age){
this.age = age;
alert("child class");
},say:function(){
alert("name:" + this.name);
alert("age:" + this.age);
}
});
var vip = new VIP("123");//1
vip.say();//2
1将打印出两条alert语句,先是
父类的构造
函数,再是子类的。
2将
输出"name: 123" "age: 123"
个人认为,这个特性并不好,因为javascript这种弱类型的语言中,根本无法确定构造
函数中的参数是传递给谁的,就比如上面的语句执行后, name="123",age="123",那哪个才是正确的?这个问题在使用dojo Grid的model里就很麻烦,定义一个model得这样:new dojox.grid._data.Table(null,data);我要是想扩展这个Model,更麻烦,所有子类的构造
函数都被
父类给搞乱了。所以推荐的做法是使用关联数组作为构造
函数的参数,就像Python里的关键字参数。
- constructor:function(args){
- varargs=args||{};
- this.name=args.name;
- this.age=args.age;
- }
constructor:function(args){
var args = args || {};
this.name = args.name;
this.age = args.age;
}
多继承,mixin
说到继承,多继承的问题又来了。dojo
支持多继承,准确地说,是mixin。还记得dojo.declare的第二个参数吗,就是表示
父类的那个参数,这个参数可以是一个数组,数组的第一个元素作为声明的类的
父类,其他的作为mixin。子类
自动获得
父类和mixin的所有
方法,后面的 mixin的同名
方法覆盖前面的
方法
dojo.declare("Customer",{
say:function(){
alert("Hello Customer");
},getDiscount:function(){
alert("Discount in Customer");
}
});
dojo.declare("MixinClass",{
say:function(){
alert("Hello mixin");
},foo:function(){
alert("foo in MixinClass");
}
});
dojo.declare("VIP",{
});
var vip = new VIP();
vip.getDiscount();
vip.foo();
vip.say();//输出"Hello MixinClass"
其他的比较有用的函数就是dojo.mixin和dojo.extend了,顾名思义,一个是作用于对象实例,一个是用于扩展class,翻文档和源码吧。
package机制
说完了dojo里的类继承机制,不得不说说package机制。
主要用到的有
dojo.require
dojo.provide
dojo.registerModulePath
dojo.require
dojo.require就是引入相应路径文件下的js文件,现在已经有很多library这样做了。现在我们假设要用
project/dojo-lib/dojo/string.js
dojo中的顶层目录就是dojo.js所在目录的上一层,即"project/dojo-lib/",而dojo.js放在
project/dojo-lib/dojo/dojo.js
所以我们就这样:
dojo.require("dojo.string");
比如要引用其他目录下的:
project/dojo-lib/dojox/dtl/_base.js,则这样:dojo.require("dojox.dtl._base");
project/dojo-lib/dojox/grid/Grid.js dojo.require("dojox.grid.Grid");
说白了,就和ruby之类的require很相似。
dojo.provide
要自己编写一个package怎么办,那就利用dojo.provide。比如要写在:
project/dojo-lib/com/javaeye/fyting/Package1.js
那么在对应的Package1.js中第一行需要这样写:
dojo.provide("com.javaeye.fyting.Package1");
类似java里的package声明,是吧?
dojo.registerModulePath
那要是我写的js文件不想和dojo放在一起怎么办呢,那就用registerModulePath。假设要放在:
project/js/com/javaeye/fyting/Package2.js
Package2.js和上面的Package1.js一样的写法,不需要作特殊变化,就这样就行:
dojo.provide("com.javaeye.fyting.Package2");
在使用时,需要指名这个Package2.js所在的位置,
dojo.registerModulePath("com","../../js/com");
只需要注意这里的相对路径是相对dojo.js来的。
我们假设所有以com.javaeye开头的js都放在一起,而com.microsoft的放在另外的地方,为了防止冲突,可以这样:
dojo.registerModulePath("com.javaeye","../../js/com/javaeye");
dojo.registerModulePath("com.microsoft","../../javascript/com/microsoft");
总得来说,package机制是开发大型项目必须的,但是造成了调试困难,使用dojo.require引入js出错时,根本不知道是什么原因,所以调试时最好手动引入js,dojo的test也是这么搞的。还有js框架中的各种实现类继承的手法,也造成调试困难,dojo还随地抛出个 Error,又缺少java那样的error statck,根本不知道错误根源在哪儿。所以,期待js原生地支持这些^^
完整的代码文件在附件里,一个是含有dojo-1.0.2的,一个是没有dojo的
发表于 @ 2008年04月29日 14:34:00|评论(1 )|编辑
@H_220_1
301@
原文链接:/dojo/291945.html