這份筆記記錄了在 Boxy 彈出層裡整合百度地圖座標拾取功能時遇到的幾個環節。開發使用的是 PHP,但問題本身出在 JavaScript 的執行順序上,與後端語言無關。
一、Boxy 載入的頁面中不能出現 script 標籤,否則內容無法正常顯示。這是因為 Boxy 透過 AJAX 取得片段內容後插入 DOM,而透過 innerHTML 插入的 script 標籤不會被執行。
二、要注意流程順序:必須先讓 Boxy 完成顯示,之後才能把地圖渲染到 Boxy 的內容區中。若在 Boxy 尚未存在於 DOM 時就試圖初始化地圖,容器找不到,自然什麼都不會發生。
三、百度地圖的 API 腳本要放在「觸發 Boxy 的那個頁面」中,而不是被載入的片段裡。原因同樣是片段中的 script 不會執行。
Boxy 的內容其實是一個獨立頁面,只是透過 $.get() 取回並交給 Boxy 顯示。片段頁面中就只有一個 id="allmap" 的 div。
(function(){
$(document).ready(function() {
$("#Mechine_mec_points").click(function(){
__MC.Map_coordinate.getcorrdinate();
});
});
__MC.Map_coordinate = {
getcorrdinate: function(){
$.get('/index.php?r=comm/map_coordinate', function(data){
new Boxy(data, {
'title': '地圖坐標拾取',
'modal': true,
'draggable': false,
'unloadOnHide': true,
'afterShow': function(){
// 關鍵:在 afterShow 中才初始化地圖
var map = new BMap.Map("allmap");
map.centerAndZoom(new BMap.Point(106.566872, 29.536861), 17);
map.enableScrollWheelZoom(); // 啟用滾輪縮放
map.enableContinuousZoom(); // 啟用地圖慣性拖曳
function showInfo(e){
$("#Mechine_mec_points").val(e.point.lng + ", " + e.point.lat);
}
map.addEventListener("click", showInfo);
}
});
return false;
});
}
}
})();
百度地圖在初始化時需要讀取容器的實際尺寸來建立畫布。若此時容器還是 display:none(Boxy 尚未顯示),讀到的寬高會是 0,地圖就會呈現一片空白或尺寸錯誤。把初始化放進 afterShow 回呼,等於保證「容器已可見、尺寸已確定」之後才動手,這是所有在彈出層中嵌入地圖、圖表、編輯器等需要測量的元件時都通用的原則。
程式碼中的註解「在外面已經加載好百度地圖 AIP 的 js」正對應了前面提到的第三點:BMap 這個建構子必須在父頁面就已存在。
unloadOnHide 與事件卸除。unloadOnHide: true 會在關閉時移除內容,避免重複開啟時疊出多個地圖實例。這點設定得很恰當。但仍建議在關閉時明確呼叫 map.destroy() 一類的清理方法,並移除 click 監聽器,否則事件處理器可能殘留在記憶體中。
API 金鑰。百度地圖 JavaScript API 需要申請 ak(金鑰)。請勿把金鑰硬寫在前端程式碼之外的地方,並在百度平台上設定域名白名單(Referer 限制),避免他人盜用你的配額。
座標格式。範例直接以 lng + ", " + lat 的字串形式寫回輸入框。若後端需要數值型別,記得用 parseFloat 轉型並驗證範圍,不要讓字串直接進資料庫;同時要注意百度使用 BD-09 座標系,與 GPS 的 WGS-84 不同,若資料要與其他系統對接必須先做座標轉換。
錯誤處理。$.get 沒有 fail 處理,一旦請求失敗,使用者按了按鈕什麼都不會發生。加上 .fail() 提示,是很基本的完成度。
最後,Boxy 這個外掛已多年未更新,新專案建議改用層級更完整的 dialog 元件(如 jQuery UI Dialog 或各框架自帶的 modal),在無障礙、焦點管理與行動版支援上都成熟得多。