很多專案都需要「等圖片載入完成後再做某事」,或者反過來「延後載入以加快首屏」。網路上現成的外掛不少,但為了這麼一個小效果額外載入一支程式庫,總覺得有點重。以下先分享一個自己寫的精簡方法,再介紹成熟的 Lazy Load 外掛。
function loadimg(arr, funLoading, funOnLoad, funOnError){
var numLoaded = 0,
numError = 0,
isObject = Object.prototype.toString.call(arr) === "[object Object]" ? true : false;
var arr = isObject ? arr.get() : arr;
for (a in arr){
var src = isObject ? $(arr[a]).attr("data-src") : arr[a];
preload(src, arr[a]);
}
function preload(src, obj){
var img = new Image();
img.onload = function(){
numLoaded++;
funLoading && funLoading(numLoaded, arr.length, src, obj);
funOnLoad && numLoaded == arr.length && funOnLoad(numError);
};
img.onerror = function(){
numLoaded++;
numError++;
funOnError && funOnError(numLoaded, arr.length, src, obj);
}
img.src = src;
}
}
參數說明:
arr:圖片路徑陣列,或選到的 img 之 jQuery 物件
funLoading:每張圖片載入完成後執行
funOnLoad:全部完成後執行
funOnError:單張載入失敗時執行
設計上的重點是用 new Image() 建立一張看不見的物件來載圖,載完再決定要不要放到畫面上——這正是預載的本質。另外注意 onerror 裡也遞增了 numLoaded,否則一張壞圖會讓計數永遠湊不齊,funOnLoad 就不會觸發。
var imgonload = function(errors){
/* errors:載入失敗的圖片數量 */
console.log("loaded, " + errors + " images loaded error!");
}
var funloading = function(n, total, src, obj){
/*
n:已完成數量;total:總數;src:當前完成的圖片路徑;
obj:若 arr 傳入路徑陣列,obj 等於 src;若傳入 jQuery 物件,obj 是該 img 的 DOM 節點
*/
console.log(n + " of " + total + " pic loaded.", src);
var newimg = document.createElement("img");
newimg.src = src;
$("body").append(newimg).fadeIn();
}
var funloading_obj = function(n, total, src, obj){
console.log(n + " of " + total + " pic loaded.", src);
$(obj).attr("src", src); // 把已載入的路徑寫回真正的 img
$(obj).fadeIn(200);
}
var funOnError = function(n, total, src, obj){
console.log("the " + n + " st img loaded Error!");
}
// 呼叫
loadimg($("img"), funloading_obj, imgonload, funOnError);
/* 或直接傳路徑陣列:
loadimg(["a.jpg", "b.jpg", "c.jpg"], funloading, imgonload, funOnError); */
funloading_obj 是實務上最常用的一種:先把 src 藏在 data-src,預載完成後才寫回真正的 src 並淡入,使用者看到的畫面因此不會有空白閃爍。
若要處理大量圖片、捲動載入等進階需求,Lazy Load 更省事。它依賴 jQuery,先引入兩支程式:
<script src="jquery.js" type="text/javascript"></script> <script src="jquery.lazyload.js" type="text/javascript"></script>
接著調整 HTML:src 放佔位圖(通常用 1x1 的灰色 GIF),真實網址放到 data-original:
<img class="lazy" src="img/grey.gif" data-original="img/example.jpg" width="640" height="480">
啟用只要一行:
$("img.lazy").lazyload();
幾乎所有瀏覽器都啟用了 JavaScript,但為了不支援的情況,可以在 noscript 裡放真圖:
<img class="lazy" src="img/grey.gif" data-original="img/example.jpg" width="640" height="480"> <noscript><img src="img/example.jpg" width="640" height="480"></noscript>
再用 CSS 隱藏佔位圖,並在 DOM ready 時顯示:
.lazy { display: none; }
$("img.lazy").show().lazyload();
提前載入(threshold):預設圖片進入視窗才載入。設為 200 表示距離視窗 200 像素時就開始載,捲動時體驗更順。
$("img.lazy").lazyload({ threshold : 200 });
事件觸發:可改用 click、mouseover 或自訂事件,讓載入時機由使用者掌控:
$("img").lazyload({
placeholder : "img/grey.gif",
event : "click"
});
切換特效:預設用 show(),可改成任何效果:
$("img.lazy").lazyload({ effect : "fadeIn" });
放在可捲動容器內:把容器作為 jQuery 物件傳入即可:
#container {
height: 600px;
overflow: scroll;
}
$("img.lazy").lazyload({ container: $("#container") });
圖片非順序排列(failure_limit):外掛會迴圈檢查尚未載入的圖片,預設遇到第一張不在可視範圍內就停止。若你的版面配置讓這個假設不成立,把門檻調高:
$("img.lazy").lazyload({ failure_limit : 10 });
延遲載入:頁面載入完成後一段時間才開始載,可減輕首屏壓力:
$(function() {
$("img:below-the-fold").lazyload({ event : "sporty" });
});
$(window).bind("load", function() {
var timeout = setTimeout(function(){ $("img.lazy").trigger("sporty") }, 5000);
});
載入隱藏圖片:為了效能,外掛預設忽略隱藏元素。若你的情境需要一併載入(例如篩選清單),把它關掉:
$("img.lazy").lazyload({ skip_invisible : false });
圖片數量少、只需要「載完再做事」,自製的 loadimg 已經夠用且零依賴。若是長頁面、大量圖片、需要捲動與降級處理,Lazy Load 這類成熟外掛省下的時間遠超過引入成本。順帶一提,現代瀏覽器已原生支援 loading="lazy" 屬性,新專案可以優先考慮這個更輕量的方案。