很多專案會需要「等圖片載完再做某事」,或反過來「先別載,滾到再看」。市面上有成熟外掛,但為一個小效果多載一支程式總覺得彆扭。其實自己寫一個也不難。
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;
}
}
參數說明:
var imgonload = function (errors) {
/* errors:載入失敗的張數 */
console.log("loaded, " + errors + " images loaded error!");
};
var funloading = function (n, total, src, obj) {
/* n:已完成張數;total:總數;src:當前路徑
obj:arr 為陣列時等於 src;arr 為 jQuery 物件時是該 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);
$(obj).fadeIn(200);
};
var funOnError = function (n, total, src, obj) {
console.log("the " + n + "th img loaded Error!");
};
console.log("loading...");
loadimg($("img"), funloading_obj, imgonload, funOnError);
// 或直接傳路徑陣列:
// loadimg(["a.jpg", "b.jpg", "c.jpg"], funloading, imgonload, funOnError);
如果想用現成套件,Lazy Load 是經典選擇。先載入依賴:
<script src="jquery.js" type="text/javascript"></script>
<script src="jquery.lazyload.js" type="text/javascript"></script>
HTML 需要改寫:src 放 1x1 的佔位圖,真實網址放到 data-original:
<img class="lazy" src="img/grey.gif" data-original="img/example.jpg" width="640" height="480">
$("img.lazy").lazyload();
把真圖片寫進 <noscript>,並用 CSS 先隱藏佔位圖:
<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>
.lazy { display: none; }
在支援 JavaScript 的環境中,於 DOM ready 時把佔位圖顯示出來:
$("img.lazy").show().lazyload();
提前載入(threshold):預設是圖片進入視窗才載。設為 200 表示距離視窗 200px 時就開始載,滑動時感覺更順。
$("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):Lazy Load 預設假定圖片在頁面上的順序與 HTML 一致,找到第一張不在視窗內的就停止。若你的版面是錯位或多欄交錯,這個假設不成立,需要調高:
$("img.lazy").lazyload({ failure_limit: 10 });
延遲載入:頁面載完 5 秒後才開始載首屏以下的圖。
$(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 });
懶載入現在已有原生標準,一行 HTML 就足夠,不必任何 JavaScript:
<img src="real.jpg" alt="說明文字" loading="lazy" width="640" height="480">
瀏覽器會自行決定時機,通常比手寫的更好。需要「載完才做某件事」時,才需要回到 new Image() 加 onload 的路線——也就是上面那個自寫 loadimg() 的思路。另外別忘了:延遲載入一定要搭配明確的 width/height(或 CSS aspect-ratio),否則圖片載入時會造成版面位移(CLS),反而傷害使用者體驗。