用 Canvas 的 drawImage() 畫圖時,很多人會遇到一個惱人的現象:第一次載入頁面圖片完全沒出現,手動重整後才正常。本文用一組「錯誤代碼 vs 修正代碼」把原因與解法講清楚。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>drawImage 測試</title>
<script src="js/jquery-1.9.1.min.js" type="text/javascript" charset="utf-8"></script>
<script type="text/javascript">
$(function () {
var JSCanv = document.getElementById("canv");
var oCanv = JSCanv.getContext("2d");
var img = new Image();
img.src = "img.png";
oCanv.drawImage(img, 220, 30);
});
</script>
</head>
<body>
<canvas id="canv" width="500" height="500">
瀏覽器不支援
</canvas>
</body>
</html>
這段代碼在邏輯上看似沒錯,但實際上只要一重整,圖片就消失。原因在於圖片載入是非同步的:
img.src 之後,瀏覽器開始去抓 img.png。drawImage()。drawImage() 之前完成——這是僥倖,不是正確。這個問題在 Chrome 19 等舊版本上特別明顯,但即使在新版瀏覽器上,只要圖片較大或網路較慢,同樣會發生。
把繪製動作放進 onload 事件,確保圖片真的就緒之後才畫:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>drawImage 修正版</title>
<script src="js/jquery-1.9.1.min.js" type="text/javascript" charset="utf-8"></script>
<script type="text/javascript">
$(function () {
var JSCanv = document.getElementById("canv");
var oCanv = JSCanv.getContext("2d");
var img = new Image();
// 先註冊事件,再指定來源,順序很重要
img.onload = function () {
oCanv.drawImage(img, 220, 30);
};
img.src = "img.png";
});
</script>
</head>
<body>
<canvas id="canv" width="500" height="500">
瀏覽器不支援
</canvas>
</body>
</html>
src 有可能讓 onload 掛上時事件已經觸發完畢,反而永遠等不到。onload 會讓失敗靜默發生,畫布永遠空白且難以排查。加上 img.onerror 印出錯誤訊息能省下很多時間。onload,不如維護一個「已完成數量」,全部載入後再統一重繪一次,可避免畫面反覆閃動。這類問題的共通教訓是:凡是涉及網路或檔案的非同步資源,都不能假設它在下一行程式碼執行時已經準備好。