| 選項 | 預設 | 說明 |
| threshold | 0 | 提前多少像素開始載入 (正數) |
| effect | show | show, fadeIn, slideDown 等 |
| effectSpeed | 0 | 動畫持續時間 (ms) |
| placeholder | 無 | 載入前顯示的圖片 URL |
| event | scroll | 觸發載入事件:scroll, click, mouseover, sporty |
| container | window | 指定捲動容器 (如 $('#scrollDiv')) |
| failurelimit | 0 | 連續多少張未在視野內才停止檢查 (優化長列表) |
事件回調
$('img.lazy').lazyload({
load: function(element, response) {
console.log('載入完成:', this.src);
},
error: function(element, response) {
console.error('載入失敗:', this.src);
this.src = 'img/error.png'; // 失敗備用圖
}
});
已知缺陷與限制
- 依賴 jQuery:增加 30KB+ 體積。
- Scroll 事件頻繁觸發:舊版用 scroll 事件輪詢,效能差 (現代版已改用
IntersectionObserver polyfill)。
- 響應式圖片支援弱:難以處理
srcset/sizes / <picture>。
- CSS 背景圖不支援:僅處理
<img>。
- SSR/SEO 問題:搜尋引擎可能不執行 JS,看不到真實圖片 (需配合
<noscript> 或 SSR 渲染)。
現代原生方案:IntersectionObserver API (零依賴、高效能、標準化)
**所有現代瀏覽器支援 (IE 需 Polyfill)**。瀏覽器原生偵測元素進入視窗,**無需監聽 scroll 事件**,主執行緒零負擔。
基礎實作 (Vanilla JS)
<img class="lazy" data-src="image.jpg" alt="描述"
src="data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7">
<script>
document.addEventListener('DOMContentLoaded', function() {
var lazyImages = document.querySelectorAll('img.lazy[data-src]');
// 建立 Observer
var observer = new IntersectionObserver(function(entries, observer) {
entries.forEach(function(entry) {
if (entry.isIntersecting) {
var img = entry.target;
var src = img.dataset.src;
// 開始載入
img.src = src;
// 載入完成移除 class、停止觀察
img.onload = function() {
img.classList.remove('lazy');
img.classList.add('loaded');
};
img.onerror = function() {
img.classList.add('error');
img.src = 'img/error.png';
};
observer.unobserve(img); // 重要:停止觀察,釋放資源
}
});
}, {
rootMargin: '200px 0px', // 提前 200px 觸發 (相當於 threshold)
threshold: 0.01 // 1% 進入視窗即觸發
});
lazyImages.forEach(function(img) {
observer.observe(img);
});
});
</script>
<style>
.img.lazy { opacity: 0; transition: opacity 0.3s; }
.img.loaded { opacity: 1; }
.img.error { opacity: 0.5; filter: grayscale(100%); }
</style>
進階:支援 srcset / picture / 背景圖 / 圖片預載入
function initLazyLoad() {
var observer = new IntersectionObserver(loadImage, {
rootMargin: '100px 0px',
threshold: 0.01
});
// 1. <img data-src data-srcset>
document.querySelectorAll('img[data-src], img[data-srcset]').forEach(function(el) {
observer.observe(el);
});
// 2. <picture> 內的 source
document.querySelectorAll('picture source[data-srcset]').forEach(function(source) {
observer.observe(source);
});
// 3. 背景圖 [data-bg]
document.querySelectorAll('[data-bg]').forEach(function(el) {
observer.observe(el);
});
function loadImage(entries, obs) {
entries.forEach(function(entry) {
if (!entry.isIntersecting) return;
var target = entry.target;
if (target.tagName === 'IMG') {
if (target.dataset.src) target.src = target.dataset.src;
if (target.dataset.srcset) target.srcset = target.dataset.srcset;
} else if (target.tagName === 'SOURCE') {
if (target.dataset.srcset) target.srcset = target.dataset.srcset;
// picture 需觸發父元素重繪
target.parentElement && (target.parentElement.style.display = 'block');
} else {
// 背景圖
target.style.backgroundImage = 'url(' + target.dataset.bg + ')';
}
target.classList.add('lazy-loaded');
obs.unobserve(target);
});
}
}
// Polyfill for IE (若需)
/*
<script>
if (!('IntersectionObserver' in window)) {
document.write('<script src="https://polyfill.io/v3/polyfill.min.js?features=IntersectionObserver"><\/script>');
}
</script>
*/
原生 loading="lazy" 屬性 (最簡單、無 JS、瀏覽器原生支援)
<!-- 現代瀏覽器 (Chrome 76+, Firefox 75+, Edge 79+, Safari 15.4+) -->
<img src="image.jpg" loading="lazy" alt="描述" width="800" height="600">
<iframe src="page.html" loading="lazy"></iframe>
- **零 JS、零設定**、瀏覽器原生最佳化 (優先級、預載入邏輯)。
- **必須指定
width/height** 或 CSS 尺寸,否則會造成版面位移 (CLS)。
- 不支援背景圖、
picture、自訂觸發邏輯。
完整最佳實踐策略 (2024+)
- 優先使用
loading="lazy":所有非首屏 <img>/<iframe>。
- 首屏關鍵圖片 (LCP 候選):
loading="eager" (預設) + fetchpriority="high" + preload。
- 複雜場景 (響應式圖片、背景圖、自訂邏輯):
IntersectionObserver 封裝元件。
- SSR/SEO:伺服端渲染真實
src,客戶端 Hydration 時加上 loading="lazy" 或 Observer。
- 佔位符:
src="data:image/svg+xml,%3Csvg xmlns='https://www.w3.org/2000/svg' viewBox='0 0 800 600'%3E%3C/svg%3E" (極小透明 SVG) 或 LQIP (Low Quality Image Placeholder) 模糊縮圖。
- 效能監控:Web Vitals (LCP, CLS)、Chrome DevTools Performance 面板。
總結
jQuery LazyLoad 是歷史產物。**現代專案首選原生 loading="lazy"**,複雜需求用 IntersectionObserver 封裝。棄用 jQuery 依賴、Scroll 事件輪詢、手動 data-src 切換。配合 width/height、fetchpriority、preload、LQIP、CDN、WebP/AVIF 格式,達成極致載入效能。
copyright ©
萬盛學電腦網 all rights reserved