百度地圖 API 除了內建的縮放、平移控制元件,也開放讓開發者挂上完全自繪的按鈕。本文分享一個實際在用的自定義控制元件寫法:在左上角放一組「重置/縮小/放大」按鈕,點下去就操作地圖視角。
<script>
var map = new BMap.Map('allmap');
var Bcenter = new BMap.Point(116.404, 39.915);
map.centerAndZoom(Bcenter, 11);
// 自定義控制元件
function staticControl(){
this.defaultAnchor = BMAP_ANCHOR_TOP_LEFT;
this.defaultOffset = new BMap.Size(10, 10);
}
// 繼承 Control 的 API
staticControl.prototype = new BMap.Control();
// 初始化控制元件
staticControl.prototype.initialize = function(map){
var div = document.createElement('div');
var e1 = document.createElement('input');
e1.type = 'button';
e1.value = '重置';
e1.onclick = function(){
statics();
}
div.appendChild(e1);
var e2 = document.createElement('input');
e2.type = 'button';
e2.value = '縮小';
e2.onclick = function(){
endStatics();
}
div.appendChild(e2);
var e3 = document.createElement("input");
e3.type = "button";
e3.value = "放大";
e3.onclick = function () {
setStatics();
}
div.appendChild(e3);
// 添加 DOM 元素到地圖中
map.getContainer().appendChild(div);
// 返回 DOM
return div;
}
// 創建控制元件實例
var staticsCtrl = new staticControl();
// 添加到地圖當中
map.addControl(staticsCtrl);
function statics(){
map.centerAndZoom(new BMap.Point(116.404, 39.915), 11);
}
function endStatics(){
map.setZoom(map.getZoom() - 2);
}
function setStatics(){
map.setZoom(map.getZoom() + 2)
}
</script>
自定義控制元件的實作可以拆成三個固定動作,記住這個套路之後要加任何按鈕都不難。
第一步,繼承 BMap.Control。把 staticControl.prototype 指向 new BMap.Control(),控制元件就取得了被地圖接管的資格。同時在建構函式裡設定 defaultAnchor(錨定位置,這裡是左上角 BMAP_ANCHOR_TOP_LEFT)與 defaultOffset(距離邊界的偏移量),決定它會出現在畫面的哪個角落。
第二步,實作 initialize 方法。這是唯一必須實作的方法,回傳值必須是一個 DOM 節點。方法內部用 createElement 把 div 與各個 input 按鈕組出來,掛上 onclick 事件,最後回傳這個 div 即可。
第三步,註冊到實例。new 出控制元件物件,呼叫 map.addControl 掛上去,它就會渲染在地圖容器裡。
縮放邏輯刻意採用相對寫法:先用 map.getZoom() 讀取目前層級,再加減固定值後呼叫 setZoom。這樣做的好處是不必寫死目標層級,使用者從任何縮放高度出發,行為都一致。
重置則直接呼叫 centerAndZoom 回到初始座標與初始層級,一鍵復原視角。若想讓按鈕邊界更靈活,也可以改傳入像素尺寸,例如 map.setZoom(map.getZoom() + 2, { width: 200, height: 200 }),讓縮放以畫面中心為基準而非左上角。
這份程式碼就是目前實際在用的版本,改成自己的按鈕配置或換成圖示樣式都很方便。