Canvas 的文本 API 是很多人會忽略的一塊。大家通常用它畫圖、畫圖表,卻很少想到它也能拿來排版文字。而事實上,Canvas 文字能做的事遠比 <p> 標籤多——漸層填色、圖案填字、只描邊不填色,這些用 CSS 很難做到的效果,在 Canvas 上只要幾行。
屬性:
font:設定或回傳目前使用的字體屬性。textAlign:設定或回傳文字的目前對齊方式。textBaseline:設定或回傳繪製文字時使用的基線。方法:
fillText():在畫布上繪製「被填充的」文字。strokeText():在畫布上繪製只有輪廓的文字(無填充)。measureText():回傳一個包含指定文字寬度的物件。本文先聚焦在顯示與渲染,也就是 font、fillText() 與 strokeText()。
首先要記住一個前提:Canvas 上的文字不能用 CSS 樣式。font 屬性寫法雖然和 CSS 幾乎一樣,但兩者不能互通,寫在 style 標籤裡對 Canvas 裡的文字毫無作用。
顯示流程固定三步:
font 設定字體。fillStyle 設定顏色。fillText() 畫出來。font 可以不設,不設時預設是 10px 無襯線體。
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<title>基本文字顯示</title>
<style>
body { background: url("./images/bg3.jpg") repeat; }
#canvas { border: 1px solid #aaaaaa; display: block; margin: 50px auto; }
</style>
</head>
<body>
<div id="canvas-warp">
<canvas id="canvas">
你的瀏覽器居然不支持 Canvas?!趕快換一個吧!!
</canvas>
</div>
<script>
window.onload = function() {
var canvas = document.getElementById("canvas");
canvas.width = 800;
canvas.height = 600;
var context = canvas.getContext("2d");
context.fillStyle = "#FFF";
context.fillRect(0, 0, 800, 600);
// 1. 設定字體
context.font = "50px serif";
// 2. 設定顏色
context.fillStyle = "#00AAAA";
// 3. 畫出文字
context.fillText("《CANVAS--Draw on the Web》", 50, 300);
};
</script>
</body>
</html>
執行結果:

設定字體非常直覺,因為格式和 CSS 的 font 完全相容:
context.font = "[font-style] [font-variant] [font-weight] [font-size/line-height] [font-family]";
五個部分都可以省略,彼此以空白分隔(原稿寫「逗號」是筆誤,實際上必須用空格)。以下逐一說明。
normal:預設值,標準樣式。italic:斜體。oblique:斜體。後兩者看起來差不多,實作方式卻不同。italic 使用的是字體檔裡本身提供的斜體字形,多數字型家族都會附帶斜體與粗體。oblique 則是把正常字形直接做切變(skew)。差別在於:如果某個字型沒有附斜體,italic 就會失效,這時只能用 oblique。
normal:預設值。small-caps:小型大寫字母。
效果如上圖:第一行是 normal,第二行是 small-caps。原本大寫的字母維持原樣,小寫字母則換成「尺寸較小的等大寫」——也就是字形變大寫,但字高不變,視覺上比全大寫柔和。
normal:預設值。bold:粗體。bolder:比目前更粗。lighter:比目前更細。xx-small、x-small、small、medium(預設)、large、x-large、xx-large50px。設定行與行之間的距離,不允許負值。不過實務上 Canvas 的多行文字需要自己用迴圈逐行 fillText,line-height 的效果得自行換算成 Y 座標增量。
規定使用的字體系列,寫法與 CSS 相同,可列多個備援。
HTML5 支援常用字體,缺少的字型可以透過 CSS 的 @font-face 擴充。它能載入伺服器端字型檔,讓使用者看到本機沒安裝的字體,目前主要支援 EOT 與 TTF 格式。

要注意的是,並不建議在正式專案中使用。中文字型檔動輒數 MB,載入成本很高。上圖的例子裡,字型檔只收錄了 A–Z 二十六個大寫字母,所以遇到小寫會自動轉大寫,遇到中文或數字則用星號符號代替——這就是字型缺字時的典型表現。另外,Canvas 繪字時若自訂字型尚未載入完成,會退回使用後備字型,需要自己處理 document.fonts.ready 之類的時序問題。
和畫矩形一樣,畫文字也有「填充」與「描邊」兩種。這兩個方法可以搭配 fillStyle 與 strokeStyle,也就是說前面講過的純色、漸層、甚至圖案填色,全部都能用在文字上。
兩者的參數表完全相同,接受四個參數:
context.fillText(String, x, y, [maxlen]);
context.strokeText(String, x, y, [maxlen]);
String 是要顯示的字串,x 與 y 是座標,maxlen 是可省略的數值參數,代表顯示的最大寬度(像素)。若文字超過這個寬度,Canvas 會把它橫向壓縮而非裁切。為了保持字形比例美觀,通常不設 maxlen。
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<title>文本渲染</title>
<style>
body { background: url("./images/bg3.jpg") repeat; }
#canvas { border: 1px solid #aaaaaa; display: block; margin: 50px auto; }
</style>
</head>
<body>
<div id="canvas-warp">
<canvas id="canvas">
你的瀏覽器居然不支持 Canvas?!趕快換一個吧!!
</canvas>
</div>
<script>
window.onload = function() {
var canvas = document.getElementById("canvas");
canvas.width = 800;
canvas.height = 600;
var context = canvas.getContext("2d");
context.fillStyle = "#FFF";
context.fillRect(0, 0, 800, 600);
context.beginPath();
context.font = "50px Verdana";
// 漸層填色
var gradient = context.createLinearGradient(0, 0, 800, 0);
gradient.addColorStop("0", "magenta");
gradient.addColorStop("0.5", "blue");
gradient.addColorStop("1.0", "red");
context.fillStyle = gradient;
context.strokeStyle = "#00AAAA";
context.strokeText("airingursb.github.io", 50, 100); // 描邊字
context.fillText("airingursb.github.io", 50, 200); // 漸層填充字
// 限制寬度:文字會被橫向壓縮
context.fillText("airingursb.github.io", 50, 300, 200);
// 用圖案填充文字
context.beginPath();
var img = new Image();
img.src = "./images/bg1.jpg";
img.onload = function() {
var pattern = context.createPattern(img, "repeat");
context.fillStyle = pattern;
context.fillText("airingursb.github.io", 50, 400);
};
context.beginPath();
context.fillStyle = "#00AAAA";
context.fillText("Airing的博客,歡迎訪問", 50, 500);
};
</script>
</body>
</html>
執行結果:

五個示範分別是:第一行用一般顏色的 strokeText() 畫出只有輪廓的字;第二行用漸層的 fillText();第三行加上 maxlen 示範壓縮;第四行用 createPattern() 把圖片當填色;第五行是普通的實心文字。
把 fillStyle 從純色換成漸層或 pattern,程式結構完全不用改——這是 Canvas 文字最迷人的地方。同一段字,換個填色就是完全不同的視覺語言。