把既有圖片畫進 Canvas,靠的是 drawImage()。這個範例示範最單純的三參數形式。
<canvas id="canvas" width="600" height="500" style="background-color: yellow;"></canvas>
var canvas = document.getElementById("canvas");
var cxt = canvas.getContext("2d");
var img = new Image();
img.src = "cat.jpg";
cxt.drawImage(img, 10, 10, 490, 382);
這裡的 drawImage(img, 10, 10, 490, 382) 代表:把 img 畫在座標 (10, 10),並縮放成寬 490、高 382。
很多人第一次寫這段代碼都會遇到同一個狀況:首次載入時畫布空白,手動重新整理後圖片才出現。原因其實很單純——圖片是「非同步」載入的,程式執行的當下 img 可能還沒下載完成,此時呼叫 drawImage() 自然畫不出任何東西;重新整理之所以有效,是因為瀏覽器已經把圖片快取起來,載入速度夠快而已。
正確做法是把繪製動作放進 onload 事件裡:
var img = new Image();
img.onload = function () {
cxt.drawImage(img, 10, 10, 490, 382);
};
img.src = "cat.jpg";
注意順序:先註冊 onload,再指定 src。如果圖片已經在快取中、載入速度極快,先設 src 有可能讓事件在監聽器掛上前就觸發完畢,反而漏掉。這個小細節在處理大量圖片資源的頁面裡特別容易踩到。