DIV CSS 佈局教程網

用 jQuery 為圖片加上 loading 與載入失敗的替代圖
編輯:JQuery入門技巧     

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

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

頁面用法

 <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 文字,讓螢幕閱讀器與圖片無法載入時的使用者都能知道這張圖是什麼。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved