萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery Boxy 彈窗整合百度地圖坐標拾取:流程與關鍵點詳解

專案背景

在 Boxy 模態彈窗中載入百度地圖,實現點擊地圖獲取經緯度並回填至父頁面表單。關鍵挑戰:Boxy 透過 AJAX 載入內容,地圖初始化時機與容器就緒時機必須同步。

關鍵流程三步驟

  1. Boxy 頁面不可包含 <script> 標籤:AJAX 回傳的 HTML 片段中若有 script,Boxy 會過濾導致地圖初始化碼不執行。
  2. 先顯示 Boxy,再初始化地圖:利用 Boxy 的 afterShow 回呼,確保容器 #allmap 已在 DOM 中且可見。
  3. 百度地圖 API 腳本需在父頁面預先載入:彈窗內容頁不載入 API,避免重複載入與作用域問題。

父頁面完整實作

<!-- 父頁面預先載入百度地圖 API -->
<script src="https://api.map.baidu.com/api?v=3.0&ak=您的AK"></script>
<script src="jquery.min.js"></script>
<script src="jquery.boxy.js"></script>

<input type="text" id="Mechine_mec_points" readonly placeholder="點擊按鈕拾取坐標" />
<button id="pickCoordBtn">拾取坐標</button>

<script>
(function() {
  $(document).ready(function() {
    $("#pickCoordBtn").click(function() {
      MapCoordinate.openPicker();
    });
  });

  var MapCoordinate = {
    openPicker: function() {
      // 1. AJAX 載入僅含地圖容器的頁面片段
      $.get('/comm/map_coordinate', function(html) {
        new Boxy(html, {
          title: '地圖坐標拾取',
          modal: true,
          draggable: false,
          unloadOnHide: true, // 關閉時銷毀 DOM
          afterShow: function() {
            // 2. Boxy 顯示後初始化地圖
            var map = new BMap.Map("allmap");
            map.centerAndZoom(new BMap.Point(106.566872, 29.536861), 17);
            map.enableScrollWheelZoom();
            map.enableContinuousZoom();

            // 3. 點擊地圖回填坐標並關閉
            map.addEventListener("click", function(e) {
              $("#Mechine_mec_points").val(e.point.lng + ", " + e.point.lat);
              Boxy.get(this).hide(); // 關閉當前 Boxy
            });
          }
        });
      });
      return false;
    }
  };
})();
</script>

地圖頁面片段(/comm/map_coordinate)

純 HTML,無 script 標籤:

<div id="allmap" style="width:100%; height:400px;"></div>
<p class="hint">點擊地圖任意位置獲取經緯度,自動填入表單並關閉彈窗。</p>

Boxy 關鍵選項說明

選項值作用
modaltrue模態遮罩,防止背景操作
draggablefalse禁止拖拽(地圖內部需拖拽移動)
unloadOnHidetrue關閉時移除 DOM,避免地圖實例殘留記憶體洩漏
afterShowfunction彈窗動畫完成後觸發,地圖初始化最佳時機

常見坑點與解決

  • 地圖顯示空白/灰格:容器初始化時 display:none 或尺寸為 0。解決:在 afterShow 中初始化,或呼叫 map.checkResize()。
  • 點擊事件不觸發:Boxy 遮罩層攔截點擊。解決:確保地圖容器 z-index 高於遮罩,或在地圖 click 事件冒泡處理。
  • 多次打開地圖重疊:未銷毀前次實例。解決:unloadOnHide: true 或手動 map.destroy()。
  • AK 限制:百度地圖 AK 需綁定域名,本地測試需配置 hosts 或使用測試 AK。
copyright © 萬盛學電腦網 all rights reserved