LazyLoad 是經典的 jQuery 圖片懶加載插件,通過 data-original 存儲真實 src,視口內才加載。雖現代項目多用 IntersectionObserver 或原生 loading="lazy",但維護老項目時仍需掌握。
src="placeholder.gif" data-original="real.jpg"$('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>
| 選項 | 類型 | 默認值 | 說明 |
|---|---|---|---|
threshold | Number | 0 | 提前加載像素距離 (如 200 = 距視口 200px 開始加載) |
event | String | 'scroll' | 觸發加載事件:'click', 'mouseover', 'sporty' (自定義) |
effect | String | 'show' | 顯示動畫:'fadeIn', 'slideDown', 自定義函數 |
container | jQuery Object | window | 滾動容器 (如帶滾動條的 div) |
failure_limit | Number | 0 | 連續幾個不在視口才停止檢查 (解決亂序佈局) |
skip_invisible | Boolean | true | 是否跳過隱藏圖片 (display:none) |
placeholder | String | - | 佔位圖 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-loadedwidth/height 或 aspect-ratio 佔位$newImg.lazyload() 或重新初始化容器根據項目技術棧選擇方案:新項目首選原生 loading="lazy" + IntersectionObserver 兜底,老項目維護 LazyLoad 即可。