Dojo中的模块,最直接的理解就是 Java 里的 Class ,只有语法的区别,概念是一样的。
使用 define 来定义一个模块,参数介绍如下:
define(自己模块名<可选>,依赖模块数组<可以为空>,function(依序的依赖模块declare){ 这里需要return一个dojo.declare对象 });、
定义一个模块,假定我们的文件名为 myModule.js
define(["dependentModuleOne","dependentModuleTwo"], function(declareModuleOne, declareModuleTwo){ // 这里必须return一个JSON对象 var myModule = {}; myModule.hello = function(){ alert("hello"); }; return myModule; });
使用一个模块
// require(["文件路径,不带扩展名","可以同时引入多个模块"], function(对前面引入模块的声明, 要按照顺序){})
require([ "myModule" ], function(myDeclare){
myDeclare.hello();
});
declare() 使用这个方法,可以声明一个Class,可以实现模块的继承和多继承,参数介绍如下:
declare("namespace.ClassName? ", [ inheritanceModelOne, inheritanceModelTwo ], { } );
- "namespace.ClassName? " :可选,不写则为匿名,dojo会自动分配一个名称;
- [ one, two ] : 这里是继承的对象,数组类型,可继承多个;
- { } : 使用 JSON 来描述你的属性和方法;
示例代码一,声明一个类
// Create a new class named "mynamespace.MyClass"
declare("mynamespace.MyClass", null, {
// Custom properties and methods here
});
// 使用这个类
var myClass = new mynamespace.MyClass();
示例代码二,匿名类
// Create a scoped, anonymous class
var MyClass = declare(null, {
// Custom properties and methods here
});
示例代码三,继承
这里先写基类:
var MyClass = declare(null, {
// Custom properties and methods here
});
// 然后派生类
var MySubClass = declare(MyClass, {
// MySubClass now has all of MyClass's properties and methods
// These properties and methods override parent's
});
示例代码四,多继承
var MyClass = declare(null, {
// Custom properties and methods here
});
var OtherClass = declare(null, {
// Custom properties and methods here
});
var ThatClass = declare(null, {
// Custom properties and methods here
});
var MyMultiSubClass = declare([
MyClass,
OtherClass,
ThatClass
],{
// MyMultiSubClass now has all of the properties and methods from:
// MyClass, OtherClass, and ThatClass
});
define([
"dojo/_base/declare",
"dijit/form/Button"
], function(declare, Button){
return declare("mynamespace.Button", Button, {
label: "My Button",
onClick: function(evt){
console.log("I was clicked!");
this.inherited(arguments);
}
});
});
require()
require也可以嵌套使用
require([ "myModule" ], function(myDeclare){
// 这里引入dojo的xmlHttpRequest模块
require(["dojo/_base/xhr"],function(xhr){
xhr.post();
});
// 这里调用我们自定义的模块
myDeclare.hello();
});
require是异步执行的,所以如果你这样写会报错的
var myVar;
require([ "myModule" ], function(myDeclare){
myVar = new myDeclare();
});
myVar.hello();
因为,require是异步执行的,在执行到myVar.hello();这句时,myModule模块还可能正在被加载——是否加载完毕由你的模块缓冲状态决定
。
(Via @glue)