萬盛學電腦網

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

鼠標懸停 3 秒延遲顯示大圖:防抖加載與居中定位實現

需求分析

  • 鼠標移入縮略圖區域,延遲 3 秒加載大圖
  • 3 秒內移出則取消加載,避免誤觸發
  • 大圖居中顯示,跟隨滾動,移出銷毀
  • 大圖地址通過 AJAX 根據商品 ID 動態獲取

核心實現:防抖 + 異步加載 + 彈層管理

;(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);

HTML 結構示例

<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>

CSS 樣式

.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%;
}

關鍵技術點總結

  1. 防抖延遲:setTimeout + clearTimeout 實現 3 秒門檻,避免輕微劃過觸發請求
  2. 請求去重/取消:變量 currentXhr 保存 jqXHR,移出時 abort() 釋放帶寬
  3. 狀態一致性:currentTrigger 確保響應屬於最新觸發元素,防止競態條件
  4. 彈層復用:單例模式管理 $preview,避免重複創建 DOM
  5. 智能定位:positionPreview() 計算視口居中,綁定 scroll/resize 實時跟隨
  6. 事件委託:$(document).on('mouseenter', '.thumb-link') 支持動態添加的縮略圖
  7. 資源清理:提供 destroy 方法,防止內存洩漏

進階優化方向

  • 圖片預加載:創建 new Image() 預載,onload 後再顯示,避免逐行渲染閃爍
  • WebP/響應式圖片:根據設備像素比請求不同尺寸
  • IntersectionObserver 預加載:縮略圖進入視口時預請求大圖,懸停時近乎秒出
  • 觸屏適配:移動端無 hover,改為長按或點擊切換模式
  • 無障礙:role="dialog"、aria-modal="true"、Esc 關閉、焦點管理

總結

「懸停延遲加載大圖」看似簡單,實則涉及防抖、異步取消、狀態同步、彈層生命周期、定位計算等多個前端工程化課題。本文提供的模塊化實現,通過閉包封裝狀態、事件委託支持動態內容、請求中斷節省資源,可直接投入生產或作為組件庫基礎進一步擴展。

copyright © 萬盛學電腦網 all rights reserved