地圖熱點(Map Hotspot)交互常用於地理可視化、樓層導覽、產品熱區標註。本文提供基於 jQuery 的輕量實現:基於 <map>/<area> 或任意定位元素,鼠標懸停顯示跟隨光標的信息框,支持 HTML 內容自動換行、IE6+ 兼容、無依賴插件,代碼量 < 100 行。
<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 動態創建 -->
.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;
}
(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 作為內容
});
.css("opacity", 0.95) jQuery 內部自動轉為 filter: alpha(opacity=95)。e.pageX/Y jQuery 標準化,跨瀏覽器可用。.stop(true) 清除隊列防止快速進出閃爍。word-break: break-all; word-wrap: break-word; 強制長單詞/連續字符換行。mousemove 中計算提示框右/下邊界是否超出 $(window).width() + scrollLeft(),超出則反向偏移。<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)、邏輯清晰,適合直接內嵌入項目或作為學習「跟隨鼠標浮層、事件委託、動畫隊列控制」的教學案例。