CanvasRenderingContext2D.font

Canvas 2D API の CanvasRenderingContext2D.font プロパティは、テキストを描画するときに用いられる現在のテキストスタイルを指定します。この文字列は CSS font 記述子 (specifier) と同じ構文を用います。デフォルトフォントは 10px のサンセリフ (sans-serif) です。

構文

ctx.font = value;

オプション

value: CSS font の値としてパースされる DOMString。デフォルトのフォントは 10px sans-serif です。

例

`font` プロパティの使用例

さまざまなフォントサイズやフォントファミリーを設定するために font プロパティを使用する、シンプルなコードスニペットです。

HTML

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

JavaScript

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

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

以下のコードを編集すると、canvas の変更個所をその場で確認できます:

CSS Font Loading API でフォントを読み込む

FontFace (en-US) API の助力により、canvas で使用する前にフォントを明示的に読み込むことができます。

var f = new FontFace("test", "url(x)");
  f.load().then(function() {
    // canvas コンテキストでフォントを使用する準備ができた
});

仕様

仕様書	策定状況	コメント
HTML Living Standard CanvasRenderingContext2D.font の定義	現行の標準

ブラウザ実装状況

BCD tables only load in the browser

Gecko 固有の注意事項

Firefox など Gecko ベースのブラウザではこのプロパティのほかに、非標準かつ非推奨の ctx.mozTextStyle を実装しています。これは使用しないでください。