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 2020年1月.
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> |
ブラウザーの互換性
Loading…