Dojo -- Getting Started篇之dojoConfig

自己也是第一次学习Dojo，从哪里下手学习Dojo呢？这个问题困扰我多日。起初我本想使用Dojo重构现有项目，采用项目驱动的方式，实战学习，后来我放弃这一做法，深怕遗漏基本的东西。后来，发现dojo的官网指南中，知识点的组织非常合理，绝对合适新手。本人之后写的关于”学习Dojo“的文章，都会参考指南中的内容，包括内容的组织方式。

介绍

如果你想对dojo中做一些配置，那么你可以使用dojoConfig对象。

Getting Started

接下来运行一个简单的例子来说明一下，如何使用dojoConfig对象对dojo进行配置。

<script> dojoConfig= { has: { "dojo-firebug": true },parseOnLoad: false,foo: "bar",async: true }; </script>
<script src="../../dojo/dojo.js"></script>

<script> require(["dijit/registry","dojo/parser","dojo/json","dojo/_base/config","dijit/Dialog","dojo/domReady!"],function(registry,parser,JSON,config) { parser.parse(); var dialog = registry.byId("dialog"); dialog.set("content","<pre>" + JSON.stringify(config,null,"\t") + "```"); dialog.show(); }); </script>

<div id="dialog" data-dojo-type="dijit/Dialog" data-dojo-props="title: 'dojoConfig / dojo/_base/config'"></div>

上面的代码非常简单，就是把dojoConfig对象转换成json字符串，然后输出到dojo的dialog中。运行效果如下：

在这里必须注意的一点是dojoConfig的配置必须在 <script src="../../dojo/dojo.js"></script> 的前面，否则运行出错。
dojoConfig除了出现在script标签中之外，还可以放在script标签的属性中，如下：

<script src="//ajax.googleapis.com/ajax/libs/dojo/1.10.4/dojo/dojo.js" data-dojo-config="has:{'dojo-firebug': true},parseOnLoad: false,foo: 'bar',async: 1"> </script>

细心的读者可能会抛出一个疑问，要是两个地方都指定dojoConfig信息，那么该听谁的？在Dojo中，它会合并两个地方配置信息，最终合并成一个。下面写一段代码来证明一下。

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Tutorial: Hello Dojo!</title>
</head>
<body>
    <script> dojoConfig = { async : true }; </script>
    <script src="../../dojo/dojo.js" data-dojo-config="has:{'dojo-firebug': true},parseOnLoad: false"></script>

    <script> require([ "dijit/registry","dojo/domReady!" ],"\t") + "```"); dialog.show(); console.log(JSON.stringify(config,"\t")); }); </script>

    <div id="dialog" data-dojo-type="dijit/Dialog" data-dojo-props="title: 'dojoConfig / dojo/_base/config'"></div>
</body>
</html>

我把

has:{'dojo-firebug': true},parseOnLoad: false

移到了script标签中的data-dojo-config属性中，运行上面的代码后，输出dojoConfig对象的信息，仍然包含了

has: {
      "dojo-firebug": true
     },parseOnLoad: false,async: true

这就说明，dojo确实合并了信息。

更多关于dojoConfig对象的配置，可以参看dojo指南

调用已经写好的js模块

如果你使用dojo中的define方法，定义了一个js模块，那么在dojo里面如何调用该模块中的的方法呢？下面给出一个简单例子。
假设我在GettingStarted/js/user/目录下写了一个common.js文件。

define([
    "dojo/dom"
],function(dom){
    return {  
        test: function(){  
            return "hello!";
        }  
    };  
});

user/common模块中，我定义了一个test方法，返回”hello!”字符串。那么在GettingStarted3.html中可以使用require加载user/common模块，并调用test方法。

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Tutorial: Hello Dojo!</title>
</head>
<body>
    <script> dojoConfig = { async: true,packages : [ { name : "user",location : "../GettingStarted/js/user" } ] }; </script>

    <script src="../../dojo/dojo.js"></script>

    <!-- 加载user/common模块 -->

    <script> require([ "user/common",function( common,parser) { parser.parse(); alert("result:"+common.test()); }); </script>
</body>
</html>

代码目录结构如下：

运行成功后，会alert一个”hello!”出来。

如果想更多的了解dojoConfig,可以查看指南一和指南二

Dojo -- Getting Started篇之dojoConfig

相关文章