因为最近想学学ArcGIS API for JavaScript ,翻了下ESRI的官网guide,发现其是基于dojo框架的,看了两页实在看不懂,于是先来熟悉下dojo框架。人蠢不能怪社会%>_<%,可能只是别人入门时甚至没当回事的问题,在我这硬是弄了好久才弄明白,就是dojo configuration中的package路径问题。
假设我的文件目录结构如下:
/
index.html
dojo-release-1.10.4
/dojo
/dojo.js
/dojox
/dijit
mytest
/myModule.js
当我需要在loader里load自定义的myModule该怎么做?
经实测,这样写是可以的:
<script type="text/javascript">
var dojoConfig={
baseUrl:"",
tlmSiblingOfDojo: false,
packages:[
{"name":"dojo","location":'dojo-release-1.10.4/dojo'},
{"name":"mytest","location":"mytest",main:"myModule"},
]
};
</script>
<script data-dojo-config="async: true" src="dojo-release-1.10.4/dojo/dojo.js"></script>
<script type="text/javascript">
require(
['mytest/myModule'],function(myModule){
//do something with myModule
})
</script>
需说明:
1.dojoConfig 必须set在加载dojo.js之前,否则在控制台调试时会发现报错。
2.baseUrl是什么?
默认值是dojo.js所在文件夹的路径,此例中即dojo-release-1.10.4/
所有的package路径都是相对于baseUrl,例如:如果我这样设置baseUrl:"/myfolder/",那么当我加载模块“mytest/myModule”,loader将会从下面路径去加载:
/myfolder/mytest/myModule.js
3.tlmSiblingOfDojo是什么?
默认值是true,此时loader将从dojo.js所在文件夹的同级文件夹中加载模块
4.packages
一个array,包含多个module及每个module对应的features。
※ name:the name of the package. 即包含了自定义module js文件的文件夹名,如此例中的“my”。
※ location:the location of the package. 可以是基于baseUrl的相对路径也可以是绝对路径。
采取相对路径时,当我require“mytest/myModule”, loader将从形如下面的路径加载module:
baseUrl+mytest的location+”/myModule.js
※ main:默认值是main.js。用于require package本身时告诉loader该去加载什么文件。例如,当我require “mytest”而不是“mytest/myModule”时,loader依然知道去load myModule.js。
另一种情况,当直接require一个没有在packages里define过的package时,如“anotherTest”时,loader将会尝试去加载下面的文件:
baseUrl+anotherTest.js