Canvas 是 HTML5 提供的一塊矩形繪圖區域,你上傳不了「圖片」給它,而是用 JavaScript ontrol 每一個像素。它能畫路徑、矩形、圓、文字,也能把外部圖片貼進來。
先建立元素,指定 id、寬與高:
<canvas id="myCanvas" width="200" height="100"></canvas>
注意 canvas 元素本身不具備任何繪圖能力,所有工作都在 JavaScript 裡完成:
<script type="text/javascript">
var c = document.getElementById("myCanvas");
var cxt = c.getContext("2d");
cxt.fillStyle = "#FF0000";
cxt.fillRect(0, 0, 150, 75);
</script>
getContext("2d") 會取得內建的 2D 繪圖物件,各種畫圖方法都挂在它下面。fillStyle 決定顏色,fillRect 決定形狀、位置與尺寸。
fillRect(0, 0, 150, 75) 的意思是:從左上角(0,0)開始,畫一個 150×75 的矩形。原點永遠在左上角,x 向右遞增、y 向下遞增——這和數學課本相反,是很多人一開始會搞錯的地方。
指定起點與終點,串起數段後描邊:
<script type="text/javascript">
var c = document.getElementById("myCanvas");
var cxt = c.getContext("2d");
cxt.moveTo(10, 10);
cxt.lineTo(150, 50);
cxt.lineTo(10, 50);
cxt.stroke();
</script>
arc(x, y, r, startAngle, endAngle, anticlockwise) 的五個參數分別是圓心 x、圓心 y、半徑、起角、終角與方向。要畫完整圓,角度給 0 到 Math.PI * 2:
<script type="text/javascript">
var c = document.getElementById("myCanvas");
var cxt = c.getContext("2d");
cxt.fillStyle = "#FF0000";
cxt.beginPath();
cxt.arc(70, 18, 15, 0, Math.PI * 2, true);
cxt.closePath();
cxt.fill();
</script>
別忘了前後的 beginPath() 與 closePath(),否則路徑會殘留,下一個圖形可能多出一條莫名的連接線。
<script type="text/javascript">
var c = document.getElementById("myCanvas");
var cxt = c.getContext("2d");
var grd = cxt.createLinearGradient(0, 0, 175, 50);
grd.addColorStop(0, "#FF0000");
grd.addColorStop(1, "#00FF00");
cxt.fillStyle = grd;
cxt.fillRect(0, 0, 175, 50);
</script>
createLinearGradient 的四個參數定義渐变的方向與起訖位置,addColorStop 的 offset 是 0 到 1 的相對位置。把兩點設成上下對齊就是垂直漸層,改呼叫 createRadialGradient 則是圓形暈染。
<script type="text/javascript">
var c = document.getElementById("myCanvas");
var cxt = c.getContext("2d");
var img = new Image();
img.src = "flower.png";
cxt.drawImage(img, 0, 0);
</script>
這裡有個常見陷阱:圖片是等非同步載入的,如果在 img.src 之後立刻 drawImage,圖很可能還沒下載完,畫布就會是空的。正確寫法是把 drawImage 放進 img.onload 裡。
不支援 canvas 的瀏覽器會直接忽略這個元素,並把標籤內的內容顯示出來。所以建議在 canvas 裡預留一段替代文字,作為最基本的向下相容處理。