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, geladen zu werden.
Syntax
load(font)
load(font, text)
Parameter
font-
Eine Schriftartspezifikation unter Verwendung der CSS-Wertesyntax, z. B. "italic bold 16px Roboto".
textOptional-
Beschränkt die Schriftschnitte auf diejenigen, deren Unicode-Bereich mindestens eines der Zeichen im Text enthält. Dies überprüft nicht die individuelle Glyphenabdeckung. Standardmäßig ist es ein String, der ein einzelnes Leerzeichen enthält (
" ").
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 je nach Erfolg oder Misserfolg beim Laden von "MyFont" erfüllt oder abgelehnt wird. Der Code in then() kann die Verfügbarkeit dieser Schriftart voraussetzen.
document.fonts.load("12px MyFont", "ß").then(/* ... */);
Spezifikationen
| Spezifikation |
|---|
| CSS Font Loading Module Level 3 # dom-fontfaceset-load |