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 erzwingt das Laden aller in den Parametern angegebenen Schriftarten.

Syntax

js
load(font)
load(font, text)

Parameter

font

eine Schriftangabe unter Verwendung der CSS-Wertsyntax, z.B. "italic bold 16px Roboto"

text

beschränkt die Schriftarten auf diejenigen, deren Unicode-Bereich mindestens eines der Zeichen im Text enthält. Dies prüft nicht die Abdeckung einzelner Glyphen.

Rückgabewert

Ein Promise, der 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 des Ladens von "MyFont" erfüllt oder abgelehnt wird. Der Code in then() kann die Verfügbarkeit dieser Schriftart annehmen.

js
document.fonts.load("12px MyFont", "ß").then(/* ... */);

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser