萬盛學電腦網

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

jQuery 實現地圖熱點提示效果:鼠標懸浮顯示信息框,支持自動換行、多瀏覽器兼容

地圖熱點(Map Hotspot)交互常用於地理可視化、樓層導覽、產品熱區標註。本文提供基於 jQuery 的輕量實現:基於 <map>/<area> 或任意定位元素,鼠標懸停顯示跟隨光標的信息框,支持 HTML 內容自動換行、IE6+ 兼容、無依賴插件,代碼量 < 100 行。

核心 HTML 結構

<div class="map-container" style="position: relative;">
    <img src="china-map.jpg" usemap="#chinaMap" alt="中國地圖" style="width: 496px; height: 415px;" />
    <map name="chinaMap">
        <area id="beijing" shape="poly" coords="..." href="javascript:;" alt="北京" />
        <area id="shanghai" shape="circle" coords="..." href="javascript:;" alt="上海" />
        <!-- 更多 area -->
    </map>
</div>
<!-- 提示框容器,JS 動態創建 -->

CSS 樣式

.map-tip {
    padding: 8px 12px;
    width: 200px; max-width: 300px;
    color: #369; background: #fff url(hotarrow.gif) no-repeat 10px center;
    border: 1px solid #369; border-radius: 4px; box-shadow: 2px 2px 8px rgba(0,0,0,.2);
    position: absolute; z-index: 9999; display: none;
    word-break: break-all; word-wrap: break-word; /* 關鍵:長內容自動換行 */
    font: 12px/1.5 "Microsoft YaHei", sans-serif;
}

核心 jQuery 插件化實現

(function($) {
    $.fn.mapTip = function(options) {
        var opts = $.extend({
            offsetX: 20,      // 橫向偏移
            offsetY: -80,     // 縱向偏移(負值向上)
            fadeDuration: 200,
            container: "body" // 掛載容器
        }, options);

        var $tip = $("#map-tip-container");
        if (!$tip.length) {
            $tip = $('
').appendTo(opts.container); } return this.each(function() { var $area = $(this); var content = $area.data("tip-content") || $area.attr("title") || $area.attr("alt"); $area.hover( function(e) { $tip.html(content) .css({ top: e.pageY + opts.offsetY, left: e.pageX + opts.offsetX, opacity: 0 }) .show().stop(true).animate({ opacity: 0.95 }, opts.fadeDuration); }, function() { $tip.stop(true).animate({ opacity: 0 }, opts.fadeDuration, function() { $(this).hide(); }); } ).mousemove(function(e) { $tip.css({ top: e.pageY + opts.offsetY, left: e.pageX + opts.offsetX }); }); }); }; })(jQuery);

初始化調用

$(function() {
    // 方式一:從 data-* 屬性讀取(推薦,支持 HTML)
    $("#beijing").mapTip({ tipContent: "
北京
人口:2154萬
" }); $("#shanghai").mapTip({ tipContent: "上海
人口:2487萬" }); // 方式二:統一配置,從 alt/title 讀取 $("area").mapTip(); // 自動讀取 alt 作為內容 });

關鍵兼容性處理

  1. IE6/7/8 透明度:.css("opacity", 0.95) jQuery 內部自動轉為 filter: alpha(opacity=95)。
  2. 事件座標:e.pageX/Y jQuery 標準化,跨瀏覽器可用。
  3. 動畫隊列:.stop(true) 清除隊列防止快速進出閃爍。
  4. 內容換行:CSS word-break: break-all; word-wrap: break-word; 強制長單詞/連續字符換行。
  5. 邊界檢測(可選增強):mousemove 中計算提示框右/下邊界是否超出 $(window).width() + scrollLeft(),超出則反向偏移。

進階:基於坐標的任意元素熱點(非 map/area)

<div class="product-image" style="position:relative;">
    <img src="phone.jpg" />
    <span class="hotspot" data-x="120" data-y="80" data-tip="前置攝像頭 3200萬"></span>
    <span class="hotspot" data-x="300" data-y="400" data-tip="指紋識別模組"></span>
</div>

<script>
$(".hotspot").each(function() {
    var $this = $(this);
    $this.css({ left: $this.data("x"), top: $this.data("y") })
         .mapTip({ tipContent: $this.data("tip"), offsetX: 10, offsetY: -60 });
});
</script>

此模式脫離 <map> 限制,支持任意定位容器內的熱點佈局,響應式更友好。

無障礙增強

  • area 添加 tabindex="0"、role="button"、aria-label,支持鍵盤聚焦觸發提示。
  • 提示框添加 role="tooltip"、aria-live="polite"。
  • 鍵盤 Enter/Space 觸發顯示,Esc 關閉。

這套方案無外部依賴、體積極小(壓縮後 < 2KB)、邏輯清晰,適合直接內嵌入項目或作為學習「跟隨鼠標浮層、事件委託、動畫隊列控制」的教學案例。

copyright © 萬盛學電腦網 all rights reserved