萬盛學電腦網

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

jQuery 實作中國地圖熱點效果:Map Area 熱區與 Tooltip 聯動

技術方案選擇

網頁地圖熱點實現方式演進:

  1. Image Map (<map> + <area>):原生 HTML、零依賴、SEO 友善、但形狀限於矩形/圓形/多邊形、樣式難控制
  2. SVG + CSS/JS:向量無限縮放、路徑精確、支援濾鏡動畫、現代標準方案
  3. Canvas:高效能、像素級控制、但需自行實現命中測試、無障礙較難
  4. WebGL (Three.js, Deck.gl):大規模資料、3D 效果、GPU 加速

本文基於原文的 `/` 方案進行現代化重構,並提供 SVG 遷移建議。

Image Map 方案完整實作

HTML 結構

<div class="map-container">
  <img id="chinaMap" src="images/china-map.png" usemap="#chinaMapAreas" alt="中國地圖">
  <map name="chinaMapAreas">
    <area shape="poly" coords="..." alt="北京" data-code="bj" data-name="北京" href="javascript:;">
    <area shape="poly" coords="..." alt="上海" data-code="sh" data-name="上海" href="javascript:;">
    <!-- 所有省份 area 標籤 -->
  </map>
  
  <!-- Tooltip 模板 (隱藏,JS 動態建立) -->
  <template id="tooltipTpl">
    <div class="map-tooltip">
      <div class="tooltip-arrow"></div>
      <strong class="tooltip-title"></strong>
      <div class="tooltip-content"></div>
    </div>
  </template>
</div>

CSS 樣式

.map-container { position: relative; display: inline-block; max-width: 100%; }
#chinaMap { display: block; width: 100%; height: auto; }

.map-tooltip {
  position: absolute;
  z-index: 100;
  min-width: 120px; max-width: 280px;
  padding: 10px 14px;
  background: rgba(30, 30, 30, 0.92);
  color: #fff;
  font-size: 13px; line-height: 1.6;
  border-radius: 6px;
  box-shadow: 0 4px 20px rgba(0,0,0,0.2);
  pointer-events: none;
  opacity: 0;
  transform: translateY(8px) scale(0.95);
  transition: opacity 0.15s ease, transform 0.15s ease;
}
.map-tooltip.show { opacity: 1; transform: translateY(0) scale(1); }
.tooltip-arrow {
  position: absolute; left: 50%; bottom: -6px; margin-left: -6px;
  border: 6px solid transparent; border-top-color: rgba(30,30,30,0.92);
}
.tooltip-title { display: block; font-size: 14px; margin-bottom: 6px; color: #ffd700; }
.tooltip-content { font-size: 12px; color: #ccc; }

jQuery 互動邏輯

(function($) {
  'use strict';
  
  var $map = $('#chinaMap');
  var $areas = $('area', $map.parent());
  var $tooltip = null;
  var tooltipTpl = $('#tooltipTpl').html();
  var currentCode = null;
  
  // 初始化 tooltip 元素
  function getTooltip() {
    if (!$tooltip) {
      $tooltip = $(tooltipTpl).appendTo('body');
      // 點擊 tooltip 內連結不關閉
      $tooltip.on('mouseenter', function() { clearTimeout(hideTimer); });
      $tooltip.on('mouseleave', function() { hideTooltip(); });
    }
    return $tooltip;
  }
  
  var showTimer, hideTimer;
  var SHOW_DELAY = 100;
  var HIDE_DELAY = 200;
  
  // 顯示 tooltip
  function showTooltip(areaEl, e) {
    clearTimeout(hideTimer);
    showTimer = setTimeout(function() {
      var $area = $(areaEl);
      var code = $area.data('code');
      var name = $area.data('name') || $area.attr('alt');
      
      // 獲取該省份資料 (可從 API 載入)
      var data = getProvinceData(code);
      
      var $tip = getTooltip();
      $tip.find('.tooltip-title').text(name);
      $tip.find('.tooltip-content').html(renderTooltipContent(data));
      
      // 計算位置:area 中心點
      var coords = $area.attr('coords').split(',').map(Number);
      var center = getPolyCenter(coords);
      var imgOffset = $map.offset();
      
      var left = imgOffset.left + center.x + 15;
      var top = imgOffset.top + center.y - $tip.outerHeight() - 10;
      
      // 邊界檢測
      var winW = $(window).width(), winH = $(window).height();
      var tipW = $tip.outerWidth(), tipH = $tip.outerHeight();
      if (left + tipW > winW - 10) left = winW - tipW - 10;
      if (top < 10) top = imgOffset.top + center.y + 15;
      
      $tip.css({ left: left, top: top }).addClass('show');
      currentCode = code;
    }, SHOW_DELAY);
  }
  
  // 隱藏 tooltip
  function hideTooltip() {
    clearTimeout(showTimer);
    hideTimer = setTimeout(function() {
      if ($tooltip) $tooltip.removeClass('show');
      currentCode = null;
    }, HIDE_DELAY);
  }
  
  // 多邊形中心點計算 (簡易版:取頂點平均)
  function getPolyCenter(coords) {
    var x = 0, y = 0, count = coords.length / 2;
    for (var i = 0; i < coords.length; i += 2) {
      x += coords[i];
      y += coords[i + 1];
    }
    return { x: x / count, y: y / count };
  }
  
  // 模擬資料
  function getProvinceData(code) {
    var mock = {
      bj: { population: '2154萬', gdp: '40271億', capital: '北京市' },
      sh: { population: '2487萬', gdp: '43214億', capital: '上海市' },
      // ...
    };
    return mock[code] || { population: '--', gdp: '--', capital: '--' };
  }
  
  function renderTooltipContent(data) {
    return '人口:' + data.population + '
GDP:' + data.gdp + '
省會:' + data.capital; } // 事件綁定 $areas .on('mouseenter', function(e) { showTooltip(this, e); }) .on('mouseleave', hideTooltip) .on('click', function(e) { e.preventDefault(); var code = $(this).data('code'); var name = $(this).data('name'); // 跳轉或載入詳細頁 window.location.href = '/province/' + code; }); // 圖片載入完成後可做初始化 (如響應式縮放時重新計算 coords) $map.on('load', function() { // 響應式:若圖片被 CSS 縮放,coords 需按比例縮放 // 可用 jQuery-rwdImageMaps 插件自動處理 }); // 全域點擊關閉 $(document).on('click', function(e) { if (!$(e.target).closest('.map-tooltip, area').length) { hideTooltip(); } }); })(jQuery);

響應式 Image Map 關鍵問題

<area coords> 是**絕對像素座標**,圖片若被 CSS 縮放 (`width: 100%`),熱區會位移錯位。

解決方案:jQuery-rwdImageMaps

<script src="jquery.rwdImageMaps.min.js"></script>
<script>
  $('img[usemap]').rwdImageMaps();  // 自動根據圖片實際顯示尺寸縮放 coords
</script>

原理

// 核心邏輯:監聽圖片 load、resize 事件
// 計算 scale = 顯示寬度 / 圖片原始寬度
// 將所有 area coords 每個數值 × scale

現代化遷移:SVG 地圖方案 (推薦)

優勢

  • 向量無損縮放,原生響應式
  • 每個省份是獨立 ``,可直接綁定事件、樣式、動畫
  • CSS 控制 hover/focus/active 狀態,無需 JS 計算位置
  • 無障礙:``、`<desc>`、`aria-label` 原生支援</li> <li>可用 `viewBox` 適配容器,完美響應式</li> </ul> <h3>SVG 版核心代碼</h3> <pre><code><svg id="chinaSvg" viewBox="0 0 1000 800" xmlns="https://www.w3.org/2000/svg"> <path id="bj" class="province" d="M..." data-name="北京" data-code="bj" /> <path id="sh" class="province" d="M..." data-name="上海" data-code="sh" /> <!-- ... --> </svg> <style> .province { fill: #97d6f5; stroke: #eee; stroke-width: 1; cursor: pointer; transition: fill 0.3s; } .province:hover, .province.active { fill: #3498db; stroke: #fff; stroke-width: 2; } .province-label { font-size: 12px; fill: #333; pointer-events: none; text-anchor: middle; } </style> <script> $('#chinaSvg .province').on('mouseenter', function() { var $this = $(this); var name = $this.data('name'); var code = $this.data('code'); // 顯示 tooltip (用 SVG <text> 或 HTML 絕對定位) }); </script></code></pre> <h2>資料視覺化整合</h2> <p>結合 ECharts、D3.js、Highcharts 等圖表庫:</p> <pre><code>// ECharts 註冊地圖 $.getJSON('china.json', function(geoJson) { echarts.registerMap('china', geoJson); var chart = echarts.init(document.getElementById('mapChart')); chart.setOption({ series: [{ type: 'map', map: 'china', data: provinceValues, // [{name: '北京', value: 2154}, ...] label: { show: true }, emphasis: { label: { show: true } } }], visualMap: { min: 0, max: 5000, inRange: { color: ['#e0f3f8', '#2c7bb6'] } } }); });</code></pre> <h2>總結</h2> <p>Image Map (`<map>/<area>`) 是零依賴、相容性最好的地圖熱點方案,適合簡單靜態地圖。核心難點在於**響應式座標同步**與**自定義 Tooltip 定位**。本文提供完整的 jQuery 實作,含延遲顯示/隱藏、邊界檢測、多邊形中心點計算。現代專案**強烈建議遷移至 SVG + CSS/JS 或 ECharts/D3**,獲得更好的開發體驗、視覺效果、無障礙支援與維護性。</p> <div class="ad2"> <script language='javascript' src='/ad/tad.js'></script> </div> </div> <div> <div class="pageNum"> <ul> <li>上一篇程序編程: <a class='LinkPrevArticle' href='https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/70849.html' >jQuery CSS 操作完全指南:樣式讀寫、類別切換、座標計算與動畫控制</a> <li>下一篇程序編程: <a class='LinkNextArticle' href='https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/70851.html' >Input 輸入框提示文字顯示/隱藏交互實現指南(Placeholder 現代方案與兼容降級)</a> </ul> </div> </div> <div class=kenbxne_js></div> </div> <div class=kenbxne_js></div> </div> <div class=kenbxne_js></div> <div class=hebxbne_left-div-2> <h2 style="text-align:left">JavaScript排行</h2> <ul> <li><a class="font7 nleft" title="jQuery 1.4 AJAX timeout 設置導致「對象不支持此操作」錯誤…" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/71131.html">jQuery 1.4 AJAX timeout 設置導致「對象不支持此操作」錯誤…</a></li> <li><a class="font7 nleft" title="Java 新手避坑指南:從工具選擇到核心 API 掌握的學習心得" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/72358.html">Java 新手避坑指南:從工具選擇到核心 API 掌握的學習心得</a></li> <li><a class="font7 nleft" title="Java 入門必修 30 大核心概念:從 OOP 基礎到集合框架與反射" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/72354.html">Java 入門必修 30 大核心概念:從 OOP 基礎到集合框架與反射</a></li> <li><a class="font7 nleft" title="原生 JavaScript 日期時間選擇器組件:支持時分選擇、鍵盤導航、多主題定…" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/71695.html">原生 JavaScript 日期時間選擇器組件:支持時分選擇、鍵盤導航、多主題定…</a></li> <li><a class="font7 nleft" title="jQuery 解決 mouseover/mouseout 多次觸發問題:mous…" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/70617.html">jQuery 解決 mouseover/mouseout 多次觸發問題:mous…</a></li> </ul> </div> <div class=kenbxne_js></div> </div> <div class="nright hebxbne_right"> <div class=guanggao1 id=guanggao_r1></div> <div class=kenbxne_js></div> <div class=hebxbne_right-div1> <h2>推薦文章</h2> <div class=kenbxne_js></div> <ul class=hebxbne_right-list1> <li><a class="font7 nleft" title="JavaScript 取得網頁最後修改時間 document.lastModif…" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/69109.html">JavaScript 取得網頁最後修改時間 document.lastModif…</a></li> <li><a class="font7 nleft" title="JavaScript 複製到剪貼簿:跨瀏覽器相容性實測與 Zero Clipbo…" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/71831.html">JavaScript 複製到剪貼簿:跨瀏覽器相容性實測與 Zero Clipbo…</a></li> <li><a class="font7 nleft" title="JavaScript typeof 與 constructor 屬性類型判斷差異…" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/69715.html">JavaScript typeof 與 constructor 屬性類型判斷差異…</a></li> <li><a class="font7 nleft" title="防止表單重複提交:JavaScript 鎖定按鈕與旗標機制實作" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/70305.html">防止表單重複提交:JavaScript 鎖定按鈕與旗標機制實作</a></li> <li><a class="font7 nleft" title="JavaScript 兩點繪製折線演算法實作" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/68706.html">JavaScript 兩點繪製折線演算法實作</a></li> <li><a class="font7 nleft" title="JavaScript 實現絢麗宇宙星空背景動畫特效" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/69596.html">JavaScript 實現絢麗宇宙星空背景動畫特效</a></li> <li><a class="font7 nleft" title="JavaScript 表格資料多模式搜尋:忽略大小寫、模糊比對、多關鍵字支援" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/69603.html">JavaScript 表格資料多模式搜尋:忽略大小寫、模糊比對、多關鍵字支援</a></li> <li><a class="font7 nleft" title="JavaScript 異常處理全攻略:try-catch-finally、thr…" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/68285.html">JavaScript 異常處理全攻略:try-catch-finally、thr…</a></li> <li><a class="font7 nleft" title="JavaScript 彈出層顯示隱藏與拖拽移動完整實現" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/71301.html">JavaScript 彈出層顯示隱藏與拖拽移動完整實現</a></li> <li><a class="font7 nleft" title="jQuery AJAX 透過 JSONP 實現跨域請求完整指南" href="https://twcomputer.wsxdn.com/programming/scripttopics/javascript/201510/70209.html">jQuery AJAX 透過 JSONP 實現跨域請求完整指南</a></li> </ul> </div> </div> <div class=kenbxne_js></div> </div> <div class=kenbxne_js></div> <div class=plnebxmj> <div class="plnebxmj-2 flink"> <h2><a class=bottom href="https://twcomputer.wsxdn.com/" target=_blank>萬盛學電腦網</a>| <a class=bottom hreflang="ja" href="https://jp.wsxdn.com/" target=_blank>日本語版</a> | <a class=bottom onclick="this.style.behavior='url(#default#homepage)';this.sethomepage('https://twcomputer.wsxdn.com');" href="#">設為首頁</a> | <a class=bottom href="javascript:window.external.addfavorite('https://twcomputer.wsxdn.com','萬盛學電腦網');">加入收藏</a></h2> </div> <div class=knemnnx></div> </div> <div class="ojwbxnks">copyright © <a title="萬盛學電腦網" href="https://twcomputer.wsxdn.com/" target=_blank>萬盛學電腦網</a> all rights reserved <br> </div> </div> </body> </html>