FontFaceSet: load() Methode

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.

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.

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

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