使用dojoConfig(djConfig)对Dojo进行全局配置以控制其默认行为。
dojo.config在Dojo启动过程中使用,有以下三种方式可以修改其默认值:
- 在引入Dojo核心模块的script标签中定义data-dojo-config属性并设定其值。
- 在引入Dojo核心模块之前定义dojoConfig对象。
- 自行编译Dojo。
1 <script src="/dojo/dojo/dojo/dojo.js" data-dojo-config="has:{‘dojo-firebug‘: true}, parseOnLoad: false, foo: ‘bar‘, async: 1"> 2 </script>
data-dojo-config属性是一个由逗号分隔的键值对集合。在某种代理情况下,这种使用方法会导致异常。
1 <script type="text/javascript"> 2 dojoConfig = { 3 has:{ 4 "dojo-firebug":true 5 }, 6 parseOnLoad:false, 7 foo:"bar", 8 async:true, 9 isDebug:true 10 }; 11 </script> 12 <script type="text/javascript" src="/dojo/dojo/dojo/dojo.js"></script>
dojoConfig必须声明在引用dojo.js的标签之前。
Dojo启动完成后,dojo.config为配置属性的存放点。
调试设置
isDebug:false
当设置为true时,Dojo会通过Firebug或者Fire不过 Lite加载其扩展的调试工具并向控制台输出调试信息。
debugContainerId:""
当指定该值时,页面加载时会寻找指定ID的元素以放置Firebug Lite。
语言和本地化设置
locale:""
默认情况下,Dojo识别客户端浏览器对象以便设置locale值。开发人员可以设置dojoConfig中的locale值以指定其值。该值必须在Dojo启动前确定,并且在启动后不可更改。该值必须为小写字母。
extraLocale:""
额外的本地化信息,为数组。
资源定位设置
baseUrl:""
当同时使用多个版本的Dojo或者dojo.js被从命名时,baseUrl用于指定Dojo核心的位置。该参数值必须是包含dojo.js文件的目录且必须以”/“结尾。
paths:"{}"
用于定位自定义模块。
其他设置
afterOnLoad:false
当需要在首次页面加载已经完成后引入dojo.js时将其配置为true。
1 <script type="text/javascript"> 2 var dojoConfig={afterOnLoad:true}; 3 window.onload=function(){ 4 var d = document.getElementsByTagName("head")[0].appendChild(document.createElement(‘script‘)); 5 d.src = "my/dojo.js"; 6 d.type = "text/javascript"; 7 } 8 </script>
addOnLoad:Function or Array
与afterOnLoad搭配使用,在dojo加载完成后调用。
require:Array
需要在dojo.js被加载后立刻加载的模块名称。
dojoBlankHtmlUrl:"dojo/resources/blank.html"
某些模块用该配置项配置空白iframe。
ioPublish:false
当允许不同的IO操作发布主题时设置为true。
transparentColor:[255,255,255]
在dojo.Color中作为透明背景色。
defaultDuration:200
默认持续时间,以毫秒记。
除了配置这些默认项外,还可以自定义配置项。