FontFaceSet

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: Dieses Feature ist verfügbar in Web Workers.

Das FontFaceSet Interface der CSS Font Loading API verwaltet das Laden von Font-Faces und das Abfragen ihres Download-Status.

Eine FontFaceSet Instanz ist ein Set-ähnliches Objekt, das eine geordnete Menge von FontFace Objekten enthalten kann.

Diese Eigenschaft ist verfügbar als Document.fonts oder self.fonts in Web-Workern.

EventTarget FontFaceSet

Instanz-Eigenschaften

FontFaceSet.status Nur lesbar

Gibt den Ladezustand des Font-Face an. Es wird entweder 'loading' oder 'loaded' sein.

FontFaceSet.ready Nur lesbar

Ein Promise, der aufgelöst wird, sobald das Laden und die Layout-Operationen abgeschlossen sind.

FontFaceSet.size Nur lesbar

Gibt die Anzahl der Werte im FontFaceSet zurück.

Ereignisse

loading

Wird ausgelöst, wenn das Laden eines Font-Face-Sets begonnen hat.

loadingdone

Wird ausgelöst, wenn das Laden eines Font-Face-Sets abgeschlossen ist.

loadingerror

Wird ausgelöst, wenn beim Laden eines Font-Face-Sets ein Fehler aufgetreten ist.

Instanz-Methoden

FontFaceSet.add()

Fügt dem Font-Set eine Schriftart hinzu.

FontFaceSet.check()

Ein boolescher Wert, der angibt, ob eine Schriftart geladen ist, initiert jedoch keinen Ladevorgang, wenn sie nicht geladen ist.

FontFaceSet.clear()

Entfernt alle manuell hinzugefügten Schriftarten aus dem Font-Set. CSS-verbundene Schriften sind nicht betroffen.

FontFaceSet.delete()

Entfernt eine manuell hinzugefügte Schriftart aus dem Font-Set. CSS-verbundene Schriften sind nicht betroffen.

FontFaceSet.entries()

Gibt einen neuen Iterator mit den Werten für jedes Element im FontFaceSet in Einfügereihenfolge zurück.

FontFaceSet.forEach()

Führt eine bereitgestellte Funktion für jeden Wert im FontFaceSet Objekt aus.

FontFaceSet.has()

Gibt ein Boolean zurück, das angibt, ob ein Element mit dem gegebenen Wert vorhanden ist.

FontFaceSet.keys()

Ein Alias für FontFaceSet.values().

FontFaceSet.load()

Gibt ein Promise zurück, das eine Liste von Font-Faces für eine angeforderte Schriftart auflöst.

FontFaceSet.values()

Gibt ein neues Iterator-Objekt zurück, das die Werte für jedes Element im FontFaceSet Objekt in Einfügereihenfolge liefert.

Spezifikationen

Specification
CSS Font Loading Module Level 3
# FontFaceSet-interface

Browser-Kompatibilität

BCD tables only load in the browser