【回顧與本篇預(yù)覽】
上篇簡單介紹了JsAPI中的數(shù)據(jù)與視圖,并告訴大家這兩部分有什么用、如何有機連接在一起。
這一篇快速介紹一下前端代碼的骨架。當(dāng)然,假定你已經(jīng)熟悉HTML5、CSS3和JavaScript(最好了解一下ES6)
轉(zhuǎn)載請注明出處,博客園/CSDN/bilibili:秋意正寒
為了方便演示,我將js代碼和css代碼全都寫在一個html文件里,當(dāng)然,更合適的做法是三者分離,不過要注意引用的順序哦。
使用上篇三維視圖的代碼↓
<!DOCTYPE html><html><head> <meta charset="utf-8"> <meta name="viewport" content="initial-scale=1,maximum-scale=1,user-scalable=no"> <title>Intro to SceneView - Create a 3D map - 4.7</title> <style> html, body, #viewDiv { padding: 0; margin: 0; height: 100%; width: 100%; } </style> <link rel="stylesheet" href="https://js.arcgis.com/4.7/esri/css/main.css"> <script src="https://js.arcgis.com/4.7/"></script> <script> require([ "esri/Map", "esri/views/SceneView", "dojo/domReady!" ], function(Map, SceneView) { var map = new Map({ basemap: "streets", ground: "world-elevation" }); var view = new SceneView({ container: "viewDiv", map: map, scale: 50000000, center: [-101.17, 21.78] }); }); </script></head><body> <div id="viewDiv"></div></body></html>
先把標(biāo)簽都折疊,過一下HTML的組成。
什么?你說你不喜歡看代碼?那怎么行,得培養(yǎng)梳理代碼的能力。我在這繼續(xù)用圖解法,剖析頁面結(jié)構(gòu):
其中,第二個script標(biāo)簽是我們自己的代碼。
link標(biāo)簽用于引用官方預(yù)設(shè)css,沒有它頁面不能工作。
第一個script標(biāo)簽用于引用JsAPI的核心文件。
注意到,body是整個頁面的組織,在這里只有一個id為viewDiv的div,用于承載視圖。
在link標(biāo)簽上還有這么一個style樣式標(biāo)簽,是對頁面樣式的預(yù)設(shè),其實很簡單,僅僅是對html的一些元素做無邊框處理而已。
把js代碼折疊后,是這樣的:
收縮起的代碼上篇已經(jīng)解釋過了,map是數(shù)據(jù),view是視圖,view通過SceneView類的構(gòu)造函數(shù)中的傳參中的map屬性進行連通,這里就不再復(fù)述。
結(jié)構(gòu)圖是這樣的:
require()是JsAPI的基礎(chǔ)——Dojo框架規(guī)定的一個全局入口,與初學(xué)C語言時接觸的main()函數(shù)類似。
第一個參數(shù),是一個字符串?dāng)?shù)組。它規(guī)定了接下來的代碼需要用哪些類(官方說法叫模塊),用字符串描述了所需類(模塊)所在的包路徑。與C#中using 命名空間;類似。
如"esri/views/SceneView"就代表引用esri這個包下的views這個包里的SceneView這個類。不妨在瀏覽器調(diào)試窗口中看看資源:
因為第一個script標(biāo)簽引用的地址是“https://js.arcgis.com/4.7/”,所以esri這個包就是基于此目錄下的相對路徑了。
同理,"esri/Map"也是這樣引用的一個類。
至于"dojo/domReady!"這個,則是dojo框架的一個特殊類(模塊),所以會在"domReady"后加一個嘆號,這是dojo的一個插件,代表DOM加載完成后再執(zhí)行后面的代碼。
回調(diào)函數(shù)的形參列表除了"dojo/domReady!"這個特殊的之外,均要與類引用列表中的類順序上一一對應(yīng),但是名字可以自由,一般與官方的類名一致。
至于本例中回調(diào)函數(shù)的內(nèi)容,上篇講過啦。
既可以用Lambda表達式,也可以在外部定義函數(shù),傳函數(shù)名進require()中。
對了,上篇沒講如何將SceneView與HTML元素綁定的,其實只是SceneView構(gòu)造函數(shù)中的一個屬性而已:
container屬性利用id選擇器(不用寫#)選擇div。
scale是比例尺,center是中央經(jīng)緯度。
由于AMD規(guī)范的要求,require()就是這么一個異步操作。你要告訴后臺,你要用哪些功能(參數(shù)1,類引用列表),你要拿這些功能做什么(參數(shù)2,回調(diào)函數(shù))。
回調(diào)函數(shù)就代表,等相關(guān)的資源準(zhǔn)備好后,再根據(jù)此回調(diào)函數(shù)做事情?;卣{(diào)函數(shù)中仍存在很多異步操作,這就是ES6中Promise的用法了,when()異步鏈?zhǔn)沟卯惒讲僮鲗懫饋砀奖悖绻麑Ξ惒胶突卣{(diào)有什么不懂的,請到網(wǎng)上查資料學(xué)習(xí),在此不展開了——但是,異步操作仍然是JsAPI中極為重要的一個技術(shù)。
總結(jié)就是,require()這個唯一入口,帶了一個引用列表(字符串?dāng)?shù)組),帶了一個回調(diào)函數(shù)。
回調(diào)函數(shù)里寫你需要做的事情,當(dāng)然,回調(diào)的形參要與引用列表一一對應(yīng)。
以下是骨架圖。
本篇到此結(jié)束,有了這個骨架,后面只是在script標(biāo)簽里加自己的內(nèi)容而已。
待工程茁壯到一定規(guī)模的時候,dojo的模塊化技術(shù)才能用得上,那并不是本入門教程的內(nèi)容了。
背景也交代完了,下篇進入約定好的幾個部分的API的講解。