文前說明:關于style就是頁面的css暫時不做評論,因為官方給的例子的樣式實在太簡單了,照抄閱讀即可。
這篇文章有着大量AJS 4.x版本添加的内容,如監聽watch、Promise對象、回調函數、異步處理等内容,原理性的東西我會在文末解釋,各位看官不用擔心看不懂,我盡量用通俗的語言解釋這些。
慣例,如果不習慣從頭看到尾,可以直接跳到後面看總結。
大家應該看過商業地圖的縮略圖功能吧?以度娘地圖為例,在使用街景地圖的時候,左下角會出現一個地點一樣的2D小地圖:
這個就是鷹眼功能的應用,在很多桌面軟體中如Erdas、Envi,鷹眼是很常見的。
//如果以下超連結日後更新了4.3或更高版本,請自行尋找4.2的sample配合本文學習~
這次就解讀2D overview map in SceneView這個例子。
源代碼:點我
其實就是一個2D的MapView在3D的SceneView的顯示而已,關鍵就在資料的同步,官方指出了watch()方法是關鍵。
話不多說,先上最終效果圖:
結構大概就是,大的DIV裡放SceneView,小的DIV裡放MapView。
小的DIV裡又有一個黑色的區域來辨別目前SceneView的區域。小的DIV的widgets被移除。
html代碼為:
<body>
<div id="viewDiv"></div>
<div id="overviewDiv">
<div id="extentDiv"></div>
</div>
</body>
老樣子,require給出引用(以前都叫第一個字元串數組參數,為了省事,以後直接叫引用了)
require(
[
"esri/Map",
"esri/views/SceneView",
"esri/views/MapView",
"esri/core/watchUtils",
"dojo/dom",
"dojo/promise/all",
"dojo/domReady!"
],
function(Map, SceneView, MapView, watchUtils, dom, all){
//你的代碼
}
);
重點應該是:
view的watch()方法、watchUtils的when方法、view的toScreen方法、view的extent屬性、view的then方法。
既然有兩個view(DIV),那麼肯定要有兩份map(資料)。
是以第二參數(以前的文章叫函數參數,之後都叫第二參數)先将map和view定義如下:
var mainMap = new Map({
basemap: "hybrid",
ground: "world-elevation"
});
var overviewMap = new Map({
basemap: "osm"
});
var mainView = new SceneView({
container: "viewDiv",
map: mainMap
});
var mapView = new MapView({
container: "overviewDiv",
map: overviewMap
});
mainMap、mainView是3D的,overviewMap、mapView是2D的。
當然,我們看到的2D的小地圖是沒有放大縮小那些控件的,隻需1行代碼,就可以置空那些控件。
mapView.ui.components = [];
查閱API,可以知道ui屬性是DefaultUI類,DefaultUI繼承自UI類。components是字元串數組,若指派為空數組則清空。相應的,DefaultUI類有remove和empty方法可以清除控件,就不細說了。
為了便于操作,把目前區域的DIV“extendDiv”的DOM元素擷取為變量:
var extentDiv = dom.byId("extentDiv");
以上就完成了準備部分。
接下來,資料加載完成後,就要對2D的地圖和3D的地圖進行“同步”了,需要用到兩個view的then方法。
then()方法是Promise對象的特有方法,而Promise是什麼暫時無需了解,隻要知道在AJS 4.x中Promise是一個很重要的東西。
而且,MapView和SceneView類都繼承了Promise類。不僅如此,AJS 4.x中很多方法傳回的都是Promise對象。
先看看mainView(3D視圖)的then方法看看它做了什麼:
mainView.then(function() {
mainView.goTo({
center: [7, 46],
scale: 200000,
heading: 35,
tilt: 60
},
{
animate: true,
duration: 100000
})
});
很好,它接受了一個參數,類型是方法。這個匿名方法幹了什麼呢?這不就是上一篇文章裡說的縮放動畫嘛!(goTo)跳過,看mapView(2D視圖)的then方法看它做了什麼:

mapView.then(function() {
mainView.watch("extent", updateOverviewExtent);
mapView.watch("extent", updateOverviewExtent);
watchUtils.when(mainView, "stationary", updateOverview);
function updateOverview() {
mapView.goTo({
center: mainView.center,
scale: mainView.scale * 2 * Math.max(mainView.width /
mapView.width,
mainView.height / mapView.height)
});
}
function updateOverviewExtent() {
var extent = mainView.extent;
var bottomLeft = mapView.toScreen(extent.xmin, extent.ymin);
var topRight = mapView.toScreen(extent.xmax, extent.ymax);
extentDiv.style.top = topRight.y + "px";
extentDiv.style.left = bottomLeft.x + "px";
extentDiv.style.height = (bottomLeft.y - topRight.y) + "px";
extentDiv.style.width = (topRight.x - bottomLeft.x) + "px";
}
});
mapView的then方法
很長的樣子。
我慢慢解釋。
仍然是接受一個方法作為參數(為什麼then接受的參數那麼奇怪?文末會解釋的)
//題外話:在javascript裡頭傳函數/方法是很常見的,函數/方法是js的一種變量類型,在C/C++裡頭可以傳遞函數指針,在C#裡頭可以傳遞委托變量。
這個方法裡有兩個方法,命名為 updateOverview 和 updateOverviewExtent,我們根據這兩個方法把這個then方法的代碼拆開看,發現watch和watchUtils.when是跟這兩個方法配對的。
即:
//兩個視圖都與updateOverviewExtent方法綁定
mainView.watch("extent", updateOverviewExtent);
mapView.watch("extent", updateOverviewExtent);
function updateOverviewExtent() {
var extent = mainView.extent;
var bottomLeft = mapView.toScreen(extent.xmin, extent.ymin);
var topRight = mapView.toScreen(extent.xmax, extent.ymax);
extentDiv.style.top = topRight.y + "px";
extentDiv.style.left = bottomLeft.x + "px";
extentDiv.style.height = (bottomLeft.y - topRight.y) + "px";
extentDiv.style.width = (topRight.x - bottomLeft.x) + "px";
}
查閱API,得知視圖的父類Accessor就支援watch方法了。值得一提的是,為了實作監聽變化,AJS4.x版本專門提供了watch方法代替了以前的舊方法。
watch的用法是:
對象.watch("該需要監聽的屬性名", 屬性變化後需要執行的回調函數);
即某對象監聽了它的某個屬性後,這個屬性一旦發生改變,就會去執行某些代碼。
在本例中,需要監聽的是兩個view對象的extent(範圍)屬性,一旦extent發生變化,那麼updateOverviewExtent()方法就會被執行。
updateOverviewExtent()方法的大概意思就是:擷取3D視圖的範圍->擷取2D視圖的對角線兩個角點->更改2D視圖上方的區域框的DOM元素的尺寸屬性(top、left、height、width)
光改變區域框是不行的,還要改變2D地圖的範圍。
watchUtils.when(mainView, "stationary", updateOverview);
function updateOverview() {
mapView.goTo({
center: mainView.center,
scale: mainView.scale * 2 * Math.max(mainView.width /
mapView.width,
mainView.height / mapView.height)
});
}
watchUtils這個對象,是位于esri/core/watchUtils子產品下的一個類。
它代表的含義是:監聽某個對象,當這個對象的某個屬性是true時,執行給定的方法。
查閱API得知,這個類提供了when這個靜态方法,when方法的意義是:
是以,在本例中,意思就是:
當mainView這個3D視圖對象的"stationary"屬性是true時,重新整理mapView這個2D視圖對象。
重新整理2D視圖對象主要用的是上一篇中說到的goTo()方法,本例隻指定了center和scale這兩個屬性組成的Object匿名對象。
SceneView類的stationary屬性是布爾類型的,意義是目前視圖是否已經靜止(一般視圖會由滑鼠拖拽或者goTo()方法産生動态效果,一旦停止下來,stationary就會變成true)
總結一下。
這個例子大概思路就是:
·先執行個體化兩個map和兩個view,對3D的mainView在建立完成後使用then()方法縮放到指定位置。
·其中,對2D的mapView建立完成後使用then()方法,分别監聽兩個view的extent屬性,還監聽3D視圖的stationary屬性。
·當extent屬性發生變化時,2D視圖上方範圍框先進行變化,然後2D地圖緊随變化。
·當3D視圖靜止下來後,重新整理2D視圖。
監聽還算比較好了解,需要注意的不多,注意到watch和watchUtils.when這兩個方法傳回的都是WatchHandle對象。待以後研究多了監聽後,再仔細看看别的監聽方法。
難點就在于then方法。
難點。
then()方法怎麼來的?這要從ES6(全名ECMAScript 2015)的新規範Promise對象說起。ECMAScript是JavaScript的标準,JS是ES的實作。
Promise是什麼?這個東西說複雜也很複雜,它是:
為了處理異步操作多層回調函數的寫法枯燥、難以閱讀維護而産生的,由CommonJS社群發起的一個新規範的類。
最顯著的特征是它執行個體化的對象都有then()和catch()方法(PromiseA+規範?好像是)
在AJS中,繼承了Promise的類有:
全部的Layers
MapView、SceneView、LayerView
ViewAnimation
能傳回Promise對象的類數不勝數。
是以說,為什麼要用Promise?
這又要從異步操作說起了。
————
在AJS 4.x中,資料(Map類)和視圖(View類)是分開的,3.x版本繪圖渲染是Map自己完成的。
由于View視圖類被分離開,繪圖邏輯就成了它的主要功能。當然,繪圖不會很快,往往有一個過程,尤其是超大資料量的繪圖的時候會有一個比較長的等待過程。
是以,在JS裡,較長的處理會丢給異步處理(就是同時進行好幾個操作)
但是但是,我們知道JS是單線程的,它是怎麼處理異步處理的呢?簡單說說,JS的異步處理其實是個“僞異步”,是先完成同步代碼才執行異步代碼的。
通常,異步代碼會做一些計算量比較大的事情,而同步代碼則做一些不怎麼耗時間的初始化工作。就是說
同步代碼花少量的時間去初始化一些事情,其間有n個異步任務丢給異步隊列。當同步代碼完成初始化後(時間短),異步代碼開始按順序執行。
比如:界面的建構交給同步代碼,而其間有n個背景資料交換、處理、計算的任務,就丢給異步隊列去準備。當界面構造好(時間往往很短,幾乎是秒速),異步代碼就在後面開始執行。
這先看到的界面會讓體驗好很多,如果異步代碼(就是耗時比較大的任務)放在同步代碼裡執行,那麼由于同步的性質,必須等待這些耗時大的任務執行完成才能繼續往下走(js的特點,單線程)
【在本例中】
初始化view,我不知道在雲端是怎麼運作的(因為我用的是CDN來運作AJS程式),但是我知道view的執行個體化肯定是用了異步操作。
即先完成網頁的加載(出現3D地球和2D地圖,同步),再進行視圖的渲染(山體拔高等,異步)。
sometimes,異步操作當然會有一個結果,比如異步在後面花好長時間算出個矩陣,但是同步代碼已經結束了,異步任務丢過去的時候結果還沒出來,怎麼擷取它?
我們可以用一個方法去擷取它。這個方法,古時候叫回調函數。
在沒有Promise類的時候,通常用回調函數這種辦法實作(也能用事件、監聽)異步是很正常的一種。
但是當回調函數本身也是個異步操作的時候,就會顯得暈頭轉向。
異步第一層,有結果要用回調函數傳回給同步代碼->回調函數是第二層,這個回調函數裡頭需要用二級回調函數傳回結果給第一層->……
舉個例子:
我是上司,我現在有兩件事:有個事兒要做,和喝茶。
這兩件事不沖突,雖然這個事兒很無聊,耗時大(如文字錄入)。
是以我把這個事兒丢給經理(異步第一層),我繼續喝茶(同步)
異步第一層就是經理要做這個事,但是這個事情絕大部分是無聊的,最後的整理比較簡單。
是以經理就把這個無聊的部分丢給職員(異步第二層),等待職員把這部分做完的同時,也去喝茶(同步)。
于是,職員的結果就是二級回調函數,職員把結果完成後,“回調”給經理。
經理拿着職員的結果整理好,“回調”給上司。(第二層異步完成)
此時上司茶已經喝完了(同步完成),而任務也完成了(第一層異步完成)。
這裡如果用老的寫法将會非常的煩,如果用Promise的then寫法就是
上司要做事兒.then(function(){讓經理去做})
.then(function(){讓職工做});
鍊式寫法,簡單,容易看,也容易維護。
then裡面的function就是回調函數,告訴異步任務完成後,要怎麼處理異步結果的一段代碼。
最後看看then方法的文法:
then(function resolve, function rejected);
我們一般隻用前一個參數,即異步成功要怎麼處理。而後一個參數是異步任務處理失敗後要做什麼。
甚至AJS官方還給出了進行中要做什麼的第三個參數...這個就不說那麼多了。
——
大概清楚是這麼個過程後,我們知道View對象是Promise對象(繼承),而且有異步操作的過程。
是以,mainView.then(function(){...});的意義就是
當3D視圖在伺服器端異步操作成功後,使用goTo()縮放到指定的位置。
文末,我還想說說監聽,監聽在AJS 3.x版本裡是通過事件完成的,而AJS 4.x全新使用了watch一派寫法。有關這些可以參考AJS 4.2的Guide文檔。
最後的最後,關于異步和回調函數部分我也是學了一天後才給出的模糊定義,希望大家能看懂吧...我也不是很能了解,官方給的多層then()是這樣的:
出處:點我
then裡頭當然是方法,無參的。隻有子一層的結果完成的時候,父一層的then才能憑借子一層的結果的回調完成異步。
給一些我閱讀中覺得不錯的對異步、回調函數講解的文章:
大白話講解Promise
ECMAScript 6入門
Javascript異步程式設計的4種方法
百度知道-JS中回調函數怎麼了解
Javascript異步程式設計之—異步原理
JS中的回調函數,以及ES6中通過promise處理回調