圖片往往佔據頁面 60%+ 流量。lazyload 只加載可視區圖片,滾動時再逐步加載其餘,是性能優化的「高性價比」手段。本文從原理到實戰,手把手教你落地。
img.src 指向 1x1 透明佔位圖(或灰色佔位符 grey.gif)。data-original(或自定義屬性)中。data-original 賦值給 src → 瀏覽器發起請求 → 加載完成可選淡入動畫。<script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/jquery-lazyload@1.9.7/jquery.lazyload.min.js"></script><img class="lazy" data-original="real-image.jpg" src="placeholder.gif" alt="描述">$(function() { $("img.lazy").lazyload({ effect: "fadeIn", threshold: 200 }); });| 參數 | 默認值 | 說明 |
|---|---|---|
| threshold | 0 | 提前加載距離(像素),如 200 表示圖片距可視區 200px 時開始加載 |
| effect | show | 顯示動畫:show/fadeIn/slideDown 或自定義函數 |
| event | scroll | 觸發加載事件:scroll/click/mouseover/custom |
| container | window | 滾動容器,適用於帶滾動條的父元素 |
| skip_invisible | true | 跳過 display:none 的圖片 |
| failure_limit | 0 | 連續多少個不可見圖片後停止檢測(優化長列表性能) |
<?php
// functions.php 或插件
add_filter('the_content', 'add_lazyload_to_images');
function add_lazyload_to_images($content) {
if (is_feed() || is_preview()) return $content;
$placeholder = get_template_directory_uri() . '/images/placeholder.gif';
return preg_replace(
'/<img([^>]+)src=[\'"]([^\'"]+)[\'"]([^>]*)>/i',
'<img$1src="' . $placeholder . '" data-original="$2"$3 class="lazy">',
$content
);
}
// 頁腳引入 JS
add_action('wp_footer', function() {
echo '<script>$("img.lazy").lazyload({effect:"fadeIn",threshold:200});</script>';
});
data-original 路徑正確、佔位圖可訪問、JS 無報錯、CSS 未設置 display:none。aspect-ratio,防止加載完成後佈局偏移(CLS 優化)。<img loading="lazy">,無需 JS,但兼容性較差(無 Safari 15-、無自定義觸發事件)。可混合使用:<img loading="lazy" data-original="..." src="placeholder.gif" class="lazy"> 並檢測 'loading' in HTMLImageElement.prototype 決定是否啟用 JS 降級。正確部署 lazyload,首屏加載時間常可縮短 30%-50%,Core Web Vitals 指標顯著改善。