;(function ($) {
'use strict';
var $preview = null; // 彈層 jQuery 對象
var loadTimer = null; // 延遲定時器
var currentXhr = null; // 當前 AJAX 請求
var currentTrigger = null; // 當前觸發元素
function showPreview($trigger, imageUrl, title) {
// 1. 創建彈層(首次或銷毀後重建)
if (!$preview) {
$preview = $('' +
'
' +
'' +
'').appendTo('body');
}
// 2. 設置內容
$preview.find('img').attr('src', imageUrl);
$preview.find('.caption').text(title || '');
// 3. 居中定位(考慮滾動)
positionPreview();
// 4. 淡入顯示
$preview.stop(true, true).fadeIn(200);
}
function hidePreview() {
if ($preview) {
$preview.stop(true, true).fadeOut(200, function () {
$preview.remove();
$preview = null;
});
}
}
function positionPreview() {
if (!$preview) return;
var winW = $(window).width();
var winH = $(window).height();
var scrollTop = $(document).scrollTop();
var pw = $preview.outerWidth();
var ph = $preview.outerHeight();
$preview.css({
left: Math.max(0, (winW - pw) / 2),
top: Math.max(0, (winH - ph) / 2) + scrollTop
});
}
// 綁定滾動/Resize 重新定位
$(window).on('scroll.resize', positionPreview);
// 事件委託:針對動態生成的縮略圖
$(document).on('mouseenter', '.thumb-link', function () {
var $this = $(this);
currentTrigger = $this;
// 防抖:3000ms 後才發起請求
loadTimer = setTimeout(function () {
// 獲取商品 ID(假設 href 格式為 /goods/123 或 ?id=123)
var href = $this.attr('href') || '';
var goodsId = href.replace(/.*[?&]id=(\d+).*/, '$1')
.replace(/.*\/goods\/(\d+).*/, '$1');
if (!goodsId || goodsId === href) return; // 解析失敗
// 取消上一個未完成的請求
if (currentXhr) {
currentXhr.abort();
}
currentXhr = $.get('/api/goods/big-image', { id: goodsId })
.done(function (data) {
if (data && data.url) {
// 確保鼠標仍在同一元素上
if (currentTrigger && currentTrigger.is($this)) {
showPreview($this, data.url, $this.attr('title') || '');
}
}
})
.fail(function () {
// 靜默失敗或顯示佔位圖
})
.always(function () {
currentXhr = null;
});
}, 3000);
}).on('mouseleave', '.thumb-link', function () {
// 移出:清除定時器、取消請求、隱藏彈層
clearTimeout(loadTimer);
if (currentXhr) {
currentXhr.abort();
currentXhr = null;
}
hidePreview();
currentTrigger = null;
});
// 暴露銷毀方法(頁面卸載或插件銷毀時調用)
$.fn.imagePreviewDestroy = function () {
clearTimeout(loadTimer);
if (currentXhr) currentXhr.abort();
hidePreview();
$(window).off('scroll.resize', positionPreview);
};
})(jQuery);
<ul class="goods-list">
<li>
<a href="/goods/1001" class="thumb-link" title="商品標題">
<img src="/images/thumb/1001.jpg" alt="" />
</a>
</li>
<li>
<a href="/goods/1002" class="thumb-link" title="另一商品">
<img src="/images/thumb/1002.jpg" alt="" />
</a>
</li>
</ul>
.img-preview {
display: none;
position: absolute;
z-index: 9999;
background: #333;
padding: 10px;
border-radius: 4px;
box-shadow: 0 4px 20px rgba(0,0,0,.3);
color: #fff;
text-align: center;
max-width: 90vw;
max-height: 90vh;
}
.img-preview img {
max-width: 100%;
max-height: 70vh;
display: block;
margin: 0 auto;
}
.img-preview .caption {
display: block;
margin-top: 8px;
font-size: 12px;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
max-width: 100%;
}
setTimeout + clearTimeout 實現 3 秒門檻,避免輕微劃過觸發請求currentXhr 保存 jqXHR,移出時 abort() 釋放帶寬currentTrigger 確保響應屬於最新觸發元素,防止競態條件$preview,避免重複創建 DOMpositionPreview() 計算視口居中,綁定 scroll/resize 實時跟隨$(document).on('mouseenter', '.thumb-link') 支持動態添加的縮略圖destroy 方法,防止內存洩漏new Image() 預載,onload 後再顯示,避免逐行渲染閃爍role="dialog"、aria-modal="true"、Esc 關閉、焦點管理「懸停延遲加載大圖」看似簡單,實則涉及防抖、異步取消、狀態同步、彈層生命周期、定位計算等多個前端工程化課題。本文提供的模塊化實現,通過閉包封裝狀態、事件委託支持動態內容、請求中斷節省資源,可直接投入生產或作為組件庫基礎進一步擴展。