dojo1.7通译 定义模块(Defining Modules)

异步加载器在除了加载原有模块外还可以加载一个新的模块类型，称为插件。使用插件来扩展新的功能。作为一个经常性的插件加载模块是和原有模块使用同样的方式，但是在模块标识符中使用!来标识这是以一个插件请求的require.将直接通过插件进行处理。这将变得更加清晰，我们看几个例子。 Dojo有一些默认插件;五个最重要的是dojo/text, dojo/i18n, dojo/has, dojo/load, 和 dojo/domReady。让我们来看看他们是如何使用。

dojo/text是更换dojo.cache，用来需要从一个文件（如HTML模板）加载一个字符串。例如，加载一个模板部件的模板，你会这样定义你的模块

// in "my/Dialog.js"
define([ "dojo/_base/declare", "dijit/Dialog", "dojo/text!./templates/Dialog.html" ], function(declare, Dialog, template){
    return declare(Dialog, {
        templateString: template // template contains the content of the file "my/templates/Dialog.html"
    });
});

?相对应于以前的版本

dojo.provide("my.Dialog");
dojo.require("dijit.Dialog");
dojo.declare("my.Dialog", dijit.Dialog, {
    templateString: dojo.cache("my", "templates/Dialog.html")
});

dojo/i18n替代了dojo.requireLocalization和dojo.i18n.getLocalization

// in "my/Dialog.js"
define([ "dojo/_base/declare", "dijit/Dialog", "dojo/i18n!./nls/common"], function(declare, Dialog, i18n){
    return declare(Dialog, {
        title: i18n.dialogTitle
    });
});

?相对应于以前的版本代码

dojo.provide("my.Dialog");
dojo.require("dijit.Dialog");
dojo.requireLocalization("my", "common");
dojo.declare("my.Dialog", dijit.Dialog, {
    title: dojo.i18n.getLocalization("my", "common").dialogTitle
});

?

新加载器实现加载了has.js功能

// in "my/events.js"
define([ "dojo/dom", "dojo/has!dom-addeventlistener?./events/w3c:./events/ie" ], function(dom, events){
    // events is "my/events/w3c" if the "dom-addeventlistener" test was true, "my/events/ie" otherwise
    events.addEvent(dom.byId("foo"), "click", function(evt){
        console.log("Foo clicked!");
    });
});

??相对应于以前的版本代码

dojo.requireIf(window.addEventListener, "my.events.w3c");
dojo.requireIf(!window.addEventListener, "my.events.ie");
my.events.addEvent(dom.byId("foo"), "click", function(evt){
    console.log("Foo clicked!");
});

dojo/load和dojo/has很相似，但dojo/load使用了两次模块定义并返回模块加载集合

// in my/loadRenderer.js
define([ "dojo/load!./sniffRenderer" ], function (renderer) {
   // do something with renderer
});
 
// in my/sniffRenderer.js
define([], function () {
  // returns an array of module identifiers to load;
  // the first module listed is the one returned by dojo/load
  return [ sniffModuleIdOfRenderer() ];
});

?但有多个模块被定义时，只取第一个模块。如果没有模块被定义，将标识undefined

? 相对应于以前的版本代码

var module = sniffModuleIdOfRenderer();
dojo.require(module);
var renderer = dojo.getObject(module);
// do something with renderer

?

dojo/domReady替换了dojo.ready,当只有dom初始化后才会执行模块

// in "my/app.js"
define(["dojo/dom", "dojo/domReady!", function(dom){
    // This function does not execute until the DOM is ready
    dom.byId("someElement");
});

?注意这里没有使用回调函数，因为这是没有意义的，这只是进行了一个延迟的操作

? 相对应于以前的版本代码

dojo.ready(function(){
    dojo.byId("someElement");
});

?处理循环依赖

当你写代码时，你可能偶尔会遇到的情况，你有两个模块，需要互相引用，此引用就形成了循环的依赖。为了解决这样一个循环依赖，加载器在第一次递归时就立即解决问题，。例如，考虑以下的例子

// in "my/a.js"
define([ "b" ], function(b){
    var a = {};
    a.stuff = function(){
        return b.useStuff ? "stuff" : "things";
    };
     
    return a;
});
 
// in "my/b.js"
define([ "a" ], function(a){
    return {
        useStuff: true
    };
});
 
// in "my/circularDependency.js"
require([ "a" ], function(a){
    a.stuff(); // "things", not "stuff"
});

?加载器在这种情况下，将尝试加载模块A，模块B，对于模块A和会发现两个模块是一个循环依赖。为了打破循环依赖，模块将被自动解析为一个空的对象。空对象将传递A的值到模块B，然后模块A的回调函数将被调用，其返回值被丢弃。在上面的例子中，这意味着将是一个空的对象，而不是一个功能的对象，所以我们的代码没有如预期般运作。

为了解决这个问题，加载器提供了一个特殊的“ exports?”模块标识符。使用时，该模块将返回空对象被用来解决循环依赖。回调被调用时，它可以附加属性出口。这种方式，功能仍然可以成功地定义和使用：