萬盛學電腦網

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

jQuery LazyLoad 插件圖片懶加載完整使用指南

jQuery LazyLoad 圖片懶加載插件:從入門到生產級配置

LazyLoad 是經典的 jQuery 圖片懶加載插件,通過 data-original 存儲真實 src,視口內才加載。雖現代項目多用 IntersectionObserver 或原生 loading="lazy",但維護老項目時仍需掌握。

基礎接入三步驟

  1. 引入 jQuery + jquery.lazyload.js
  2. 修改 HTML:src="placeholder.gif" data-original="real.jpg"
  3. 初始化:$('img.lazy').lazyload()

完整基礎示例


<head>
  <script src="jquery.js"></script>
  <script src="jquery.lazyload.js"></script>
</head>
<body>
  <img class="lazy" src="img/grey.gif" data-original="img/photo.jpg" width="640" height="480">
  <script>
    $("img.lazy").lazyload();
  </script>
</body>

核心配置選項詳解

選項類型默認值說明
thresholdNumber0提前加載像素距離 (如 200 = 距視口 200px 開始加載)
eventString'scroll'觸發加載事件:'click', 'mouseover', 'sporty' (自定義)
effectString'show'顯示動畫:'fadeIn', 'slideDown', 自定義函數
containerjQuery Objectwindow滾動容器 (如帶滾動條的 div)
failure_limitNumber0連續幾個不在視口才停止檢查 (解決亂序佈局)
skip_invisibleBooleantrue是否跳過隱藏圖片 (display:none)
placeholderString-佔位圖 URL

進階配置示例


// 1. 提前 200px 加載 + 淡入動畫
$("img.lazy").lazyload({ 
  threshold: 200, 
  effect: "fadeIn" 
});

// 2. 點擊加載 (畫廊預覽模式)
$("img.gallery").lazyload({
  placeholder: "img/placeholder.jpg",
  event: "click"
});

// 3. 容器內懶加載 (橫向滾動列表)
$("#scroll-container").css({ height: "600px", overflow: "scroll" });
$("img.lazy").lazyload({ 
  container: $("#scroll-container") 
});

// 4. 亂序佈局 (瀑布流、Masonry)
$("img.lazy").lazyload({ 
  failure_limit: 10 // 找到 10 個不在視口才停止
});

// 5. 延遲初始化 (頁面載入 5 秒後才開始懶加載)
$(function() {
  $("img.lazy").lazyload({ event: "sporty" });
});
$(window).on("load", function() {
  setTimeout(() => $("img.lazy").trigger("sporty"), 5000);
});

// 6. 加載隱藏圖片 (Tab 切換、篩選場景)
$("img.lazy").lazyload({ skip_invisible: false });

// 7. 無 JS 降級

// CSS 隱藏佔位圖
.lazy { display: none; }
// JS 顯示並初始化
$("img.lazy").show().lazyload();

響應式圖片配合



  
  
  

// 需插件支持 data-srcset 或自行擴展

遷移到現代方案對比

方案優點缺點適用場景
jQuery LazyLoad兼容 IE6+、API 成熟、事件靈活依賴 jQuery、滾動監聽性能一般老項目維護、複雜事件觸發需求
IntersectionObserver原生、高性能、無依賴需 Polyfill 支持舊瀏覽器現代項目首選
loading="lazy"零代碼、瀏覽器原生優化不可控制閾值、不支持背景圖、Safari 較晚支持簡單頁面、漸進增強

常見問題排查

  • 圖片不加載:檢查 data-original 拼寫、選擇器匹配、容器滾動事件綁定
  • 重複加載:確保加載後移除 data-original 或標記 data-loaded
  • 佈局跳動:設置 width/height 或 aspect-ratio 佔位
  • 動態新增圖片:$newImg.lazyload() 或重新初始化容器

根據項目技術棧選擇方案:新項目首選原生 loading="lazy" + IntersectionObserver 兜底,老項目維護 LazyLoad 即可。

copyright © 萬盛學電腦網 all rights reserved