HTML5 規範帶來許多新特性,其中最受期待的一項就是 Canvas 元素。它提供了一套透過 JavaScript 繪製圖形的方法,API 淺顯易懂,能力卻相當強大。每個 Canvas 元素都擁有一個「上下文(context)」,你可以把它想成繪圖板上的一頁紙,在其中畫出任何圖形。瀏覽器支援多個上下文,並透過不同的 API 提供各異的繪圖能力。
主流瀏覽器都支援 2D Canvas 上下文,包含 Opera、Firefox、Konqueror 與 Safari;部分版本的 Opera 亦支援 3D Canvas,Firefox 則可透過外掛擴充取得 3D 能力。
本文聚焦 2D Canvas 的基礎用法,示範如何用基本 API 畫出線條、形狀、圖片與文字。閱讀前,最好先具備 JavaScript 基礎。
建立 Canvas 非常簡單,在 HTML 中插入元素即可:
<canvas id="myCanvas" width="300" height="300">
這是一個 Canvas 標籤案例
</canvas>
實務上建議替它設定 ID,方便日後在 JavaScript 中抓取出來;寬高也應明確指定,否則預設尺寸往往不是你要的。
要在畫布上作畫就必須動用 JavaScript。流程固定為三步:用 getElementById 找到元素、初始化上下文、呼叫上下文 API 繪圖。以下腳本會畫出一個矩形:
var elem = document.getElementById('myCanvas');
if (elem && elem.getContext) {
var context = elem.getContext('2d');
if (context) {
context.fillRect(0, 0, 150, 100);
}
}
這段程式碼可以放在文件的 head 中,也可以抽到外部 JavaScript 檔裡。
矩形是最容易上手的圖形。透過 fillStyle 與 strokeStyle 屬性,可以自由設定填充色與線條色,數值寫法與 CSS 完全一致:十六進位、rgb()、rgba() 與 hsla() 都吃。
三個矩形相關方法的參數相同,依序為 x, y, width, height——前兩個決定左上角座標,後兩個決定寬與高:
fillRect:畫出帶填充的矩形strokeRect:只畫外框、不填充clearRect:清除指定區域綜合範例:
context.fillStyle = '#00f';
context.strokeStyle = '#f00';
context.lineWidth = 4;
context.fillRect (0, 0, 150, 50);
context.strokeRect(0, 60, 150, 50);
context.clearRect (30, 25, 90, 60);
context.strokeRect(30, 25, 90, 60);
想畫任意形狀,就得用路徑。做法是先描述輪廓,再決定要不要填色或描邊。用 beginPath() 起筆,接著以直線、曲線等指令勾勒形狀,完成後呼叫 fill() 填色、stroke() 描邊,最後以 closePath() 收尾。以下示範一個三角形:
context.fillStyle = '#00f';
context.strokeStyle = '#f00';
context.lineWidth = 4;
context.beginPath();
context.moveTo(10, 10);
context.lineTo(100, 10);
context.lineTo(10, 100);
context.lineTo(10, 10);
context.fill();
context.stroke();
context.closePath();
drawImage 可以把外部圖片(img 元素)或另一塊 canvas 畫進來,Opera 甚至支援直接繪製 SVG 圖形。這個方法有三種參數形式:
// 三個參數:最基礎用法,指定圖片與它在畫布上的位置
context.drawImage(img_elem, dx, dy);
// 五個參數:加上目標寬高,可縮放圖片
context.drawImage(img_elem, dx, dy, dw, dh);
// 九個參數:最完整形式,多出四個參數描述「來源區域」
// 允許在繪製前先裁切原圖
context.drawImage(img_elem, sx, sy, sw, sh, dx, dy, dw, dh);
九參數版本是做精靈圖動畫的關鍵——把來源區域一幀一幀挪動,就能從一張拼接圖上取出連續動畫。
2D Context API 提供三個方法處理像素:createImageData、getImageData 與 putImageData。
它們圍繞著 ImageData 物件運作。這個物件有三個屬性:width、height 與 data。其中 data 型別為 CanvasPixelArray,用來存放 width × height × 4 個數值——每個像素佔四格,依序是紅、綠、藍與 alpha 透明度,取值範圍 0 至 255。像素排列由左至右、由上而下,逐行存放。
建立一份空白的像素資料並全部填成半透明紅:
var imgd = context.createImageData(50, 50);
var pix = imgd.data;
for (var i = 0, n = pix.length; i < n; i += 4) {
pix[i ] = 255;
pix[i+3] = 127;
}
context.putImageData(imgd, 0, 0);
注意:並非所有瀏覽器都實作了 createImageData。在不支援的環境中,需改用 getImageData 取得 ImageData 物件。
有了像素層級的存取權,能做的事就多了:自製圖像濾鏡、做數學視覺化(分形、粒子特效)都難不倒你。以下示範最經典的「反轉色」濾鏡:
var imgd = context.getImageData(x, y, width, height);
var pix = imgd.data;
for (var i = 0, n = pix.length; i < n; i += 4) {
pix[i ] = 255 - pix[i ];
pix[i+1] = 255 - pix[i+1];
pix[i+2] = 255 - pix[i+2];
}
context.putImageData(imgd, x, y);
Text API 的支援起步較晚(近期的 WebKit 與 Firefox 3.1 nightly 才開始支援),但為了內容完整,仍在此說明。context 上可設定三個文字屬性:
font:字型設定,寫法同 CSS 的 font 相關屬性textAlign:水平對齊,可取 start / end / left / right / center,預設 starttextBaseline:垂直對齊,可取 top / hanging / middle / alphabetic / ideographic / bottom,預設 alphabetic繪製方法有兩個:fillText 畫出帶填充的文字,strokeText 則只描邊。兩者參數相同——文字內容、座標 (x, y),以及一個選用的最大寬度;若文字過長,瀏覽器會自動壓縮以符合指定寬度。對齊屬性會直接影響文字相對於座標點的擺放方式。
context.fillStyle = '#00f';
context.font = 'italic 30px sans-serif';
context.textBaseline = 'top';
context.fillText ('Hello world!', 0, 0);
context.font = 'bold 30px sans-serif';
context.strokeText('Hello world!', 0, 50);
Shadows API 早期僅有 Konqueror 與 Firefox 3.1 nightly 支援,包含四個屬性:
shadowColor:陰影顏色,寫法同 CSS 顏色值shadowBlur:模糊程度,數值越大越模糊,效果等同 Photoshop 的高斯模糊shadowOffsetX / shadowOffsetY:陰影的 X、Y 位移量,單位為像素context.shadowOffsetX = 5;
context.shadowOffsetY = 5;
context.shadowBlur = 4;
context.shadowColor = 'rgba(255, 0, 0, 0.5)';
context.fillStyle = '#00f';
context.fillRect(20, 20, 150, 100);
除了純色,fillStyle 與 strokeStyle 也能指定為 CanvasGradient 物件,讓線條與填充使用漸層。建立方式有兩種:createLinearGradient 產生線性漸層,createRadialGradient 產生圓形漸層。建立完成後,再透過 addColorStop 逐一加入色點。
var gradient1 = context.createLinearGradient(sx, sy, dx, dy);
gradient1.addColorStop(0, '#f00');
gradient1.addColorStop(0.5, '#ff0');
gradient1.addColorStop(1, '#00f');
var gradient2 = context.createRadialGradient(sx, sy, sr, dx, dy, dr);
把 gradient1 指派給 fillStyle,就能畫出紅到黃再到藍的平滑過渡;改用 createRadialGradient 則可得到以起點半徑與終點半徑描述的光暈效果。
Canvas 是 HTML5 最令人期待的特性之一,目前也已獲得絕大多數瀏覽器支援。從矩形、路徑、圖片到像素操作、文字、陰影與漸層,2D Context API 幾乎涵蓋了網頁端 2D 繪圖的所有需求——足以支撐遊戲開發,也能大幅強化圖形介面的表現力。希望這篇文章能幫你跨過入門門檻,並讓你想繼續往下探索。