Dojo definedeclare

Posted 2020-10-05 Andy.zhu

Define

先看define。作用是定义一个模块（module）。这个模块可以被require引用，引用了之后就可以使用define里面的东西。一个模块想当然，里面干什么事情，不一定全部自己实现。就像人要coding，除了脑子，也不能没有电脑、键盘。因此，define的第一个参数就是将要用到的其他模块引进来。第二个参数描述这个模块具体干什么，并且给第一个参数中的模块分别起一个朗朗上口的名字。就像下面这段代码描述的样子。

 

util.js

define([ "dojo/dom"], function(dom) {
return {
setRed: function(id){
dom.byId(id).style.color = "red";
}
};
});

这是一个工具模块，其中一个功能就是把网页上id对应的DOM节点变成红色。当我们要使用它的时候，就可以用require了。

 

test.jsp

<script>
require(
[ "dojo/ready", "test/util" ],
function(ready, util) {
ready(function() {
var id = "selected_text";
util.setRed(id);
});
});
</script>

Declare

可以看到，上面的模块util作为工具模块，可以在被引用后任意调用其功能。这是无状态的，就好象是一个singleton的对象。但如果我们想定义“类”一样的东西，有状态，可以创建多个对象，就需要在define里用declare。最典型的例子就是dijit下面的诸多UI小控件。

举个很简单的例子，我希望基于dijit.Dialog，创建一个有特殊功能的dialog，每次打开后能把上面的一段text标记为红色。

 RedTextDialog.js

define([ "dojo/_base/declare", "dijit/Dialog", "dijit/_WidgetBase",
"dijit/_TemplatedMixin", "test/util" ], function(declare,
Dialog, _WidgetBase, _TemplatedMixin, util) {
return declare("test.RedTextDialog", [ Dialog, _WidgetBase, _TemplatedMixin ], {
title: "Dialog with Red Text",

onDownloadEnd : function() {
var id = "selected_text";
util.setRed(id);
}
});
});

RedTextDialog可以重写dijit.Dialog所有的方法，也可以自创方法、变量，实现自己想要的任意功能。接下来可以用require使用它。

<script>
require(
[ "dojo/ready", "test/RedTextDialog" ],
function(ready, RedTextDialog) {
ready(function() {
var dialog = new RedTextDialog();
dialog.show();
});
});
</script>