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>
可以看到,每次使用RedTextDialog時,都可以創建一個新的對象實例,因此可以做到互相之間沒有關系。
目錄結構
為了在test.jsp中調用上述js文件,需要在test.jsp聲明js文件的位置。
- <script>
- dojoConfig = {
- isDebug : false,
- parseOnLoad : true,
- async : true,
- packages : [
- {
- name : "test",
- location : "../../js/test"
- }
- ]
- };
- </script>
最后,約定俗成地,一般define類似util的singleton模塊,js文件的名字第一個字母小寫;而類似RedTextDialog的類模塊,第一個字母大寫。