本文分析 HTML5 中 drawImage 使用時常遇到的一個問題及解法,供參考。
先看一段看似正常的寫法:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title></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>
這段程式碼其實是有問題的:一重新整理,圖片就消失不見了。要保證重新整理後仍能正常顯示,必須在 Image 的 onload 時機重繪一次。這個問題在 Chrome 19 下特別容易出現。
根本原因很直白:img.src 指定之後,圖片是「非同步」載入的,程式執行到 drawImage 時圖片往往還沒下載完成,此時畫上去的等於是一張空圖。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title></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";
img.onload = function() {
oCanv.drawImage(img, 220, 30);
}
})
</script>
</head>
<body>
<canvas id="canv" width="500" height="500">
瀏覽器不支援
</canvas>
</body>
</html>
把繪製動作放進 onload 回呼之後,無論首次載入還是重新整理,圖片都能穩定畫出來。實務上如果圖片來自快取,部分瀏覽器可能觸發時序略有差異,此時可再搭配 img.complete 做一次判斷,確保兩種情況都被涵蓋。