要在地圖上加右鍵選單,第一步是攔下右鍵點擊。HTML 元素上的右鍵事件名為 contextmenu,按下右鍵即觸發,在回呼函數裡顯示選單即可。
問題是:在 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 事件綁定沒有兩樣,這裡就不再展開。實作時還可再補上點擊地圖其他地方自動關閉選單、以及視窗滾動時重新定位這類細節,讓互動更順手。