DIV CSS 佈局教程網

OpenLayers 3 實作地圖右鍵自定義選單
編輯:關於JavaScript     

要在地圖上加右鍵選單,第一步是攔下右鍵點擊。HTML 元素上的右鍵事件名為 contextmenu,按下右鍵即觸發,在回呼函數裡顯示選單即可。

問題是:在 OpenLayers 中要從哪裡下手?這得先了解它的初始化過程。

OpenLayers 的頁面初始化結構

我們通常先在頁面放一個 div(假設 id 為 map),初始化地圖時指定它。OpenLayers 會在這個元素中建立一個 class 為 ol-viewport 的 div,尺寸與外層一致;接著在其中放入 canvas 元素,地圖就渲染在這塊畫布上。此外還會加入 class 為 ol-overlaycontainer 的 div 用來承放 overlay,以及 class 為 ol-overlaycontainer-stopevent 的 div 用來放置各項控制元件。

最終形成的 DOM 結構如下:

圖1 形成的DOM結構

很自然地會想:直接在 map div 上綁事件不就得了?確實可行,但後續會遇到麻煩——選單彈出來之後,通常要針對「使用者點的那個地點」做操作,而事件物件給的是螢幕座標,要換算成地圖座標系下的座標相當棘手。

困難在哪裡?

首先,事件物件的座標是相對於瀏覽器視口、頁面或整個螢幕的;其次,顯示地圖的元素大小和位置都是浮動的;最後,螢幕座標系與地圖座標系往往完全不同。要把「相對於地圖元素的位置」再轉成「地圖座標系下的座標」,靠手動計算既繁瑣又容易出錯。

所幸 OpenLayers 已經把這件事包好了。map.getEventCoordinate(event) 一行就能完成全部換算,因為只有它最清楚地圖目前的投影、縮放與平移狀態。下面看具體實作。

實作步驟

整個功能拆成三小步:為元素綁定 contextmenu 事件、取得點擊位置的地圖座標、在該位置顯示選單。以下代碼使用 jQuery 簡化操作。

1. 綁定 contextmenu 事件

注意不要與 HTML 新增的 contextmenu 屬性混淆——那個屬性目前只有 Firefox 支援,我們用的是 oncontextmenu 事件,主流瀏覽器都支援。由於瀏覽器自帶右鍵選單,記得要 preventDefault 把它關掉:

 $(map.getViewport()).on("contextmenu", function(event){ e.preventDefault(); // 書寫事件觸發後的函數 });

map.getViewport() 會回傳前述那個 ol-viewport 元素,也就是直接包住地圖的節點,事件綁在它上面最合適。

2. 取得點擊處的地圖座標

 var coordinate = map.getEventCoordinate(event);

這個函數內部會呼叫 map.getCoordinateFromPixel(),參數是 ol.pixel 格式的 [x, y],再往下由 ol.vec.Mat4.multVec2() 完成矩陣運算,把螢幕像素轉成地圖座標。

3. 在該位置挂上選單

先在頁面準備選單的容器:

 <div id="contextmenu_container" class="contextmenu"> <ul> <li><a href="#">設置中心</a></li> <li><a href="#">添加地標</a></li> <li><a href="#">距離丈量</a></li> </ul> </div>

用它初始化一個 Overlay 並掛到地圖上:

 var menu_overlay = new ol.Overlay({ element: document.getElementById("contextmenu_container"), positioning: 'center-center' }); menu_overlay.setMap(map);

然後在右鍵事件的回呼裡設定位置:

 menu_overlay.setPosition(coordinate);

選單隱藏

選單不能一直掛在地圖上。加上左鍵點擊時隱藏,或在按下某個選項後隱藏,都只需把位置設為 undefined:

 menu_overlay.setPosition(undefined);

放在左鍵事件的回呼函數或各選項的處理函數中即可。

總結

本文重點在於理解 OpenLayers 的 DOM 結構,以及用 getEventCoordinate 把滑鼠事件座標轉為地圖座標這個關鍵環節。至於選單裡每個項目要綁什麼功能,跟一般 JavaScript 事件綁定沒有兩樣,這裡就不再展開。實作時還可再補上點擊地圖其他地方自動關閉選單、以及視窗滾動時重新定位這類細節,讓互動更順手。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved