設計圖片較多的頁面時,為了改善使用者體驗,我們往往希望圖片在載入過程中先顯示一個 loading 動畫,而不是從空白突然蹦出完整圖片。在 Zen Cart 的二次開發中就遇到過這個需求,以下是我的解法。
img 一個 loading 動畫圖作為佔位 src,並指派一個 id。load 事件,等真實圖片載入完成後,再把 src 換掉。<img id="loading1" src="loading.gif" />
function addListener(element, type, expression, bubbling) {
bubbling = bubbling || false;
if (window.addEventListener) { // 標準瀏覽器
element.addEventListener(type, expression, bubbling);
return true;
} else if (window.attachEvent) { // 舊 IE
element.attachEvent('on' + type, expression);
return true;
}
return false;
}
var ImageLoader = function(url) {
this.url = url;
this.image = null;
this.loadEvent = null;
};
ImageLoader.prototype = {
load: function() {
this.image = document.createElement('img');
var url = this.url;
var image = this.image;
var loadEvent = this.loadEvent;
addListener(this.image, 'load', function(e) {
if (loadEvent != null) {
loadEvent(url, image);
}
}, false);
this.image.src = this.url;
},
getImage: function() {
return this.image;
}
};
// 對外介面:指定要替換的元素 id 與真實圖片網址
function loadImage(objId, urls) {
var loader = new ImageLoader(urls);
loader.loadEvent = function(url) {
var obj = document.getElementById(objId);
obj.src = url;
};
loader.load();
}
<img id="loading1" src="loading.gif" />
<script language="javascript">
loadImage("loading1", "https://www.baidu.com/img/baidu_logo.gif");
</script>
呼叫 loadImage 時,內部透過 addListener 註冊 load 事件,因此圖片一載入完成就會自動把 loading.gif 這個過渡動畫替換成真圖。
今天的瀏覽器已提供 Image 物件的 decode() 與 loading="lazy" 屬性,可以做得更簡潔:
async function loadImage(imgEl, url) {
const img = new Image();
img.src = url;
await img.decode(); // 等待解碼完成,避免閃動
imgEl.src = url;
imgEl.classList.add('loaded');
}
/* 搭配 CSS 淡入 */
img { opacity: 0; transition: opacity .3s; }
img.loaded { opacity: 1; }
另外別忘了加上寬高屬性或 aspect-ratio,以免圖片載入時版面跳動(CLS);若要處理載入失敗,記得同時掛上 error 事件回退到預設圖。