在前端開發中,我們常需在圖片完全載入後才能正確獲取其寬高、執行動畫初始化或觸發後續渲染邏輯。若過早操作,可能導致尺寸為 0 或佈局錯亂。本文整理三種常見做法:onload 屬性、原生 JS 綁定、jQuery 事件委派。
onload 屬性直接在 <img> 標籤上綁定事件處理函式。
<img class="pic1" onload="get(this)" src="..." style="display:none" />
<script>
function get(ts) {
ts.style.display = 'block'; // 載入完成後顯示
}
</script>
優點: 寫法直觀,可用於任意圖片,JS 程式碼位置靈活。
缺點: 每個圖片都得加屬性,HTML 與行為耦合,不利維護;無法在無法修改 HTML 的場景使用。
onload透過 DOM API 選取元素並指定回呼。
<img id="pic1" src="..." />
<script>
document.getElementById('pic1').onload = function () {
alert('圖片載入已完成');
};
</script>
優點: 不污染 HTML,關注點分離。
缺點: 單一元素綁定;腳本必須置於圖片元素之後,或放在 DOMContentLoaded 中,否則可能找不到元素。
.load() 事件委派利用 jQuery 批量綁定,並配合淡入動畫。
<script>
$(function(){
$('.pic1').each(function() {
$(this).load(function(){
$(this).fadeIn();
});
});
});
</script>
注意: 勿在 $(document).ready() 內綁定 load,否則可能因圖片已快取而錯過事件。
優點: 批量處理、鏈式語法優雅、不侵入 HTML。
缺點: 依賴 jQuery 庫;同樣需確保綁定時機早於圖片載入完成。
Promise 封裝現代專案建議封裝為 Promise,配合 async/await 使用,更符合當代開發習慣:
function loadImage(src) {
return new Promise((resolve, reject) => {
const img = new Image();
img.onload = () => resolve(img);
img.onerror = reject;
img.src = src;
});
}
// 使用
loadImage('photo.jpg').then(img => {
document.body.appendChild(img);
console.log('寬度:', img.width);
});
根據專案技術棧選擇:無框架項目用原生綁定;已引入 jQuery 可用 .load();新專案推薦 Promise 封裝,語義清晰且易於錯誤處理。