CanvasRenderingContext2D：font 属性

Baseline 2025
Newly available

Since March 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Canvas 2D API 的 CanvasRenderingContext2D.font 属性指定绘制文字所使用的当前字体样式。使用和 CSS 字体描述符相同的字符串值。

值

一个被解析为 CSS font 值的字符串。默认字体为 10 像素的无衬线体（sans-serif）。

示例

使用自定义字体

这个示例使用 font 属性设置了自定义的字体粗细、大小和字体家族。

HTML

html
<canvas id="canvas"></canvas>

JavaScript

js
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

ctx.font = "bold 48px serif";
ctx.strokeText("Hello world", 50, 100);

结果

使用 CSS 字体加载 API 加载字体

借助 FontFace API 的帮助，你可以在画布中使用字体之前显式加载字体。

js
let f = new FontFace("test", "url(x)");

f.load().then(() => {
  // 准备在画布上下文中使用字体
});

规范

Specification
HTML
# dom-context-2d-font-dev

浏览器兼容性

参见