FontFaceSet: load() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

load() は FontFaceSet のメソッドで、引数で指定されたフォントをすべて読み込ませます。

構文

js
load(font)
load(font, text)

引数

font

CSS の値構文を使用するフォント指定。例えば "italic bold 16px Roboto" です。

text

Unicode 範囲がテキスト中の文字の少なくとも 1 つを含んでいるフォントフェイスに限定します。これは個々のグリフが網羅されているかどうかは調べません。

返値

Promise で、読み込まれた FontFace オブジェクトの配列 (Array) で履行されます。このプロミスは、すべてのフォントが読み込まれたときに履行され、フォントが 1 つでも読み込めなかった場合は拒否されます。

例

次の例は、 "MyFont" の読み込みが成功したかどうかに応じて履行または拒否されるプロミスを返します。 then() のコードは、そのフォントが利用できるとみなされます。

js
document.fonts.load("12px MyFont", "ß").then(/* ... */);

仕様書

Specification
CSS Font Loading Module Level 3
# dom-fontfaceset-load

ブラウザーの互換性

BCD tables only load in the browser