FontFaceSet: load() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。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(/* ... */);
仕様書
| 仕様書 |
|---|
| CSS Font Loading Module Level 3 # dom-fontfaceset-load |