圖片较多的頁面常有兩個困擾:載入過程中一片空白,以及某張圖掛了之後出現破圖的圖示。整理成一個小外掛,兩件事可以一起解決。

最後一張是載入失敗時顯示的替代圖。

<div class="container">
<div class="row block" id="img-list">
<div class="col-md-3"><img src="/Assets/OnePiece/1.jpg" class="img-thumbnail" /></div>
<div class="col-md-3"><img src="/Assets/OnePiece/2.jpg" class="img-thumbnail" /></div>
<div class="col-md-3"><img src="/Assets/OnePiece/3.jpg" class="img-thumbnail" /></div>
<div class="col-md-3"><img src="/Assets/OnePiece/4.jpg" class="img-thumbnail" /></div>
<div class="col-md-3"><img src="/Assets/OnePiece/5.jpg" class="img-thumbnail" /></div>
<div class="col-md-3"><img src="/Assets/OnePiece/6.jpeg" class="img-thumbnail" /></div>
<div class="col-md-3"><img src="/Assets/OnePiece/7.jpg" class="img-thumbnail" /></div>
<div class="col-md-3"><img src="/Assets/OnePiece/8.jpg" class="img-thumbnail" /></div>
</div>
</div>
<script src="~/Scripts/ImgLoading/ImgLoading.js"></script>
<script>
$("#img-list").ImgLoading({
errorimg: "/Scripts/ImgLoading/images/noimage.png",
loadimg: "/Scripts/ImgLoading/images/load.gif",
timeout: 800
});
</script>
為了讓載入效果看得清楚,範例刻意加了延遲時間。
;(function ($) {
$.fn.extend({
ImgLoading: function (options) {
var defaults = {
errorimg: "預設的破圖替代圖路徑",
loadimg: "預設的載入動畫路徑",
Node: $(this).find("img"),
timeout: 1000
};
var options = $.extend(defaults, options);
var Browser = new Object();
var plus = {
// 判斷瀏覽器核心
BrowserVerify: function(){
Browser.userAgent = window.navigator.userAgent.toLowerCase();
Browser.ie = /msie/.test(Browser.userAgent);
Browser.Moz = /gecko/.test(Browser.userAgent);
},
// 把真實 src 暫存起來,先把畫面換成載入動畫
LoadState: function(){
defaults.Node.each(function (i) {
var img = defaults.Node.eq(i);
img.attr("imgurl", img.attr("src"));
img.attr("src", defaults.loadimg);
});
},
// 逐一預載
EachImg: function () {
defaults.Node.each(function (i) {
var img = defaults.Node.eq(i);
plus.LoadEnd(Browser, img.attr("imgurl"), i, plus.LoadImg);
});
},
// 用 new Image() 在背景載入,完成後再換回來
LoadEnd: function (Browser, url, imgindex, callback) {
var img = new Image();
if (Browser.ie) {
img.onreadystatechange = function () {
if (img.readyState == "complete" || img.readyState == "loaded") {
callback(img, imgindex);
}
};
} else if (Browser.Moz) {
img.onload = function () {
if (img.complete == true) { callback(img, imgindex); }
};
}
img.onerror = function () { img.src = defaults.errorimg; };
img.src = url;
},
// 依 timeout 延遲套用,讓動畫有機會被看到
LoadImg: function (obj, imgindex) {
setTimeout(function () {
defaults.Node.eq(imgindex).attr("src", obj.src);
}, defaults.timeout);
}
};
plus.LoadState();
plus.BrowserVerify();
plus.EachImg();
}
});
})(jQuery);
流程是這樣的:LoadState 先把每張圖的真實網址存進自訂的 imgurl 屬性,再把 src 換成載入動畫;接著 EachImg 用 new Image() 在背景默默下載;下載完成後由 LoadImg 把真正的 src 換回去。載入失敗則由 onerror 換成替代圖。
用 new Image() 預載是關鍵技巧:瀏覽器有快取機制,背景下載完成後,真正套用到 img 上時幾乎是瞬間顯示,使用者就看不到破圖或空白。
1. 用 load/error 事件取代核心判斷。範例針對 IE 與 Gecko 分別用 onreadystatechange 與 onload,這是照顧舊瀏覽器的寫法。現代瀏覽器直接用 img.onload 與 img.onerror 即可,程式碼能少一半:
var img = new Image();
img.onload = function(){ target.attr('src', url); };
img.onerror = function(){ target.attr('src', defaults.errorimg); };
img.src = url;
2. 自訂屬性改用 data-*。img.attr("imgurl", ...) 是非標準寫法,建議改成 $(this).data('src', ...) 或 HTML5 的 data-src,語意更清楚也更容易被其他工具理解。
3. 更簡潔的方案:懶載入。如果目的是「不要一次載入全部圖片」,直接用原生 loading="lazy" 屬性即可,瀏覽器會自動在圖片接近視窗時才載入。搭配 decoding="async" 還能改善解碼效能。再加上 width 與 height 屬性配置版面,可以有效避免載入時的配置位移。
4. 別忘了 alt。替代圖只是視覺上的補救,真正的無障礙方案是為每張圖片寫好 alt 文字,讓螢幕閱讀器與圖片無法載入時的使用者都能知道這張圖是什麼。