FontFaceSet: load() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die load()-Methode des FontFaceSet zwingt alle in den Parametern angegebenen Schriftarten zum Laden.
Syntax
load(font)
load(font, text)
Parameter
font-
eine Schrifttypenspezifikation unter Verwendung der CSS-Wertesyntax, z. B. "italic bold 16px Roboto"
text-
Beschränken Sie die Schriftarten auf diejenigen, deren Unicode-Bereich mindestens eines der Zeichen im Text enthält. Diese überprüft nicht die Abdeckung einzelner Glyphen.
Rückgabewert
Ein Promise, das mit einem Array von geladenen FontFace-Objekten erfüllt wird. Das Versprechen wird erfüllt, wenn alle Schriftarten geladen sind; es wird abgelehnt, wenn eine der Schriftarten nicht geladen werden konnte.
Beispiele
Das folgende Beispiel gibt ein Versprechen zurück, das entsprechend dem Erfolg des Ladens von "MyFont" erfüllt oder abgelehnt wird. Der Code in then() kann die Verfügbarkeit dieser Schriftart annehmen.
document.fonts.load("12px MyFont", "ß").then(/* ... */);
Spezifikationen
| Spezifikation |
|---|
| CSS Font Loading Module Level 3 # dom-fontfaceset-load |