上一篇說明了 canvas 的定位,這篇我們直接動手。
先從元素定義看起:
<canvas id="tutorial" width="150" height="150"></canvas>
它長得很像 <img>,差別在於沒有 src 與 alt 屬性。<canvas> 只有 width 與 height 兩個屬性,兩者都是可選的,也可以用 DOM 屬性或 CSS 來設定。若不指定,預設是寬 300px、高 150px。
雖然可以用 CSS 任意縮放 canvas 的顯示尺寸,但渲染時圖像會被縮放以適應版面——如果你發現畫面變形了,與其依賴 CSS,不如直接在 <canvas> 上明確寫出 width 與 height。
id 不是 canvas 專屬屬性,幾乎每個 HTML 元素都能用。但為 canvas 加上 id 是很值得的習慣,因為在腳本裡抓元素會方便很多。
canvas 也能像一般圖片一樣套用樣式(邊距、邊框、背景等),但這些樣式不會影響 canvas 實際繪製的內容。若不套用任何樣式,canvas 預設是全透明的。
因為 canvas 相對新,有些瀏覽器(如 Firefox 1.0 與 Internet Explorer)並未實作,所以我們需要為不支援的環境準備替用內容。
做法很直覺:直接把替代內容寫在 canvas 元素內部。不支援的瀏覽器會忽略 canvas 標籤而渲染裡面的內容,支援的瀏覽器則正常繪製 canvas。你可以放一段文字描述,或放一張靜態圖:
<canvas id="stockGraph" width="150" height="150"> current stock price: $3.15 +0.15 </canvas> <canvas id="clock" width="150" height="150"> <img src="images/clock.png" width="150" height="150"/> </canvas>
在 Apple Safari 的實作裡,<canvas> 和 <img> 一樣,沒有結束標籤。但為了讓 canvas 能在網路上廣泛通用,必須有地方放替用內容,因此 Mozilla 的實作要求寫上 </canvas>。
如果你不需要替用內容,那麼 <canvas id="foo" ...></canvas> 這種寫法在 Safari 與 Mozilla 之間是完全相容的——Safari 會直接忽略結束標籤。若需要替用內容,就得用一些 CSS 技巧讓 Safari 看不到替用內容、同時讓 IE 看不到那些 CSS 技巧。
<canvas> 建立的是一塊固定尺寸的繪圖區域,並開放一個或多個渲染上下文(rendering context)供我們操作內容。目前唯一被定義的是 2D 上下文,未來可能會加入基於 OpenGL ES 的 3D 上下文。
canvas 初始化時是空白的,要畫東西得先取得渲染上下文。canvas 元素有個名為 getContext 的 DOM 方法,傳入一個描述上下文類型的參數,就能取得上下文及其繪圖函式:
var canvas = document.getElementById('tutorial');
var ctx = canvas.getContext('2d');
第一行用 getElementById 取得 canvas 的 DOM 節點,第二行透過 getContext 取得繪圖上下文。
除了用替用內容因應不支援的瀏覽器,腳本本身也可以做偵測。最簡單的方式就是判斷 getContext 是否存在:
var canvas = document.getElementById('tutorial');
if (canvas.getContext) {
var ctx = canvas.getContext('2d');
// drawing code here
} else {
// canvas-unsupported code here
}
後續範例都會從這個最精簡的模板出發,建議存一份下來:
<html>
<head>
<title>Canvas tutorial</title>
<script type="text/javascript">
function draw() {
var canvas = document.getElementById('tutorial');
if (canvas.getContext) {
var ctx = canvas.getContext('2d');
}
}
</script>
<style type="text/css">
canvas { border: 1px solid black; }
</style>
</head>
<body onload="draw();">
<canvas id="tutorial" width="150" height="150"></canvas>
</body>
</html>
這裡我定義了一個名為 draw 的函式,透過 body 上的 onload 屬性,在頁面載入完成後執行一次。它當然也可以放在 setTimeout、setInterval 或其他事件處理函式中呼叫,只要確保頁面已經載入即可。
來畫兩個交錯的矩形,其中一個帶 alpha 透明度:
<html>
<head>
<script type="application/x-javascript">
function draw() {
var canvas = document.getElementById("canvas");
if (canvas.getContext) {
var ctx = canvas.getContext("2d");
ctx.fillStyle = "rgb(200,0,0)";
ctx.fillRect(10, 10, 55, 50);
ctx.fillStyle = "rgba(0, 0, 200, 0.5)";
ctx.fillRect(30, 30, 55, 50);
}
}
</script>
</head>
<body onload="draw();">
<canvas id="canvas" width="150" height="150"></canvas>
</body>
</html>
把這段存成 HTML 檔打開,你會看到一個紅色矩形被一個半透明藍色矩形覆蓋。透明度如何影響顏色重疊的視覺結果,我們會在後續範例中詳細說明。