Canvas 是 HTML5 中相當強大的繪圖工具。本文系統性地整理它的核心用法,從建立畫布、繪製文字與路徑,到處理背景與貼圖,幫助你一次掌握 Canvas 的關鍵 API。
<canvas id="canvas" width="600" height="400"></canvas>
你也可以在標籤內放入替代文字,供不支援 Canvas 的瀏覽器顯示:
<canvas id="canvas" width="600" height="400">
<p>Your browser does not support the canvas element.</p>
</canvas>
目前新版瀏覽器多半已支援 HTML5,開始實作前請確認使用的是新版 Chrome、Firefox 或 IE9 以上版本。canvas 標籤本身不具備作畫能力,它只是提供一塊繪圖區域,真正的繪製要靠 JavaScript 完成。準備工作如下:
var canvas = document.getElementById("canvas");
var context2D = canvas.getContext("2d");
先取得畫布物件,再用 getContext("2d") 取得二維繪圖物件。目前唯一可用的參數就是 "2d"。取得的 Context 物件包含大量繪圖方法,操作它即可畫出各種圖形。
使用 fillText() 可以在畫布上繪製文字,其原型為:
void fillText(text, left, top, [maxWidth]);
四個參數分別是:要繪製的文字、文字左上角在畫布中的橫座標與縱座標,以及文字的最大寬度(maxWidth 為可選參數)。此外,可透過 font 屬性調整字體與大小,預設為 "10px sans-serif"。
context2D.font = "35px Times New Roman";
context2D.fillText("Hello Canvas!", canvas.width / 2, canvas.height / 2);
Canvas 的基本圖形都以路徑為基礎。通常先用 moveTo()、lineTo()、rect()、arc() 等方法描出路徑點,再用 fill() 或 stroke() 依路徑填充或描邊。開始前建議先呼叫 beginPath() 清除舊路徑,否則 stroke 時會把先前所有路徑一起重繪,既影響效果也拖慢效能;closePath() 則可顯式關閉當前路徑,但不會清除它。
常用路徑方法:
void moveTo(x, y):指定路徑起點。預設第一條路徑起點為 (0, 0),之後則是上一條路徑的終點。
void lineTo(x, y):從起點畫一条直线到指定位置,之後起點會移動到該位置。
void rect(left, top, width, height):依左上角座標與寬高描繪矩形,完成後起點移到矩形左上角。
void arcTo(x1, y1, x2, y2, radius):描繪與兩條線段相切的圓弧。
void arc(x, y, radius, startAngle, endAngle, anticlockwise):以 (x, y) 為圓心、radius 為半徑,從起始弧度畫到終止弧度;anticlockwise 為 true 代表逆時針,false 代表順時針。弧度 0 位於 3 點鐘方向,Math.PI 位於 9 點鐘方向。
void quadraticCurveTo(cpx, cpy, x, y):以目前起點為起點、(cpx, cpy) 為控制點、(x, y) 為終點的二次曲線。
void bezierCurveTo(cpx1, cpy1, cpx2, cpy2, x, y):以目前起點為起點、兩個控制點與一個終點的貝茲曲線。
路徑完成後,可呼叫 stroke() 描邊、fill() 填充,或用 clip() 設定剪輯區域。呼叫 clip 後,繪圖只會作用於剪輯區域內;若未先描繪路徑,剪輯區域即為整個畫布。
調整線條與填充風格的屬性包括:strokeStyle(線條顏色,預設 #000000)、fillStyle(填充顏色)、lineWidth(線寬,預設 1.0)、lineCap(端點樣式:butt、round、square)、lineJoin(轉角樣式:round、bevel、miter)、miterLimit(尖角銳利度,預設 10)等。
Context 物件還提供三個可直接在畫布上作畫、不需經過路徑的方法,可視為直接在背景上繪製:
void fillRect(left, top, width, height):以目前 fillStyle 填充矩形。
void strokeRect(left, top, width, height):以目前線條風格繪製矩形邊框。
void clearRect(left, top, width, height):清除指定矩形區域內的所有內容。
使用 drawImage() 可把外部圖片繪製進畫布,共有三種原型:
drawImage(image, dx, dy);
drawImage(image, dx, dy, dw, dh);
drawImage(image, sx, sy, sw, sh, dx, dy, dw, dh);
下圖說明了各參數的意義:

其中 image 可以是 HTMLImageElement、HTMLCanvasElement 或 HTMLVideoElement。以下範例把一張圖片繪製到畫布左上角:
var pic = new Image();
pic.src = "/School/UploadFiles_7810/201603/20160312210113203.jpg";
context2D.drawImage(pic, 0, 0);
以上程式碼均通過 Google Chrome 14.0 及 Mozilla Firefox 7.0 瀏覽器測試。