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.

* Some parts of this feature may have varying levels of support.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Das FontFaceSet-Interface der CSS Font Loading API verwaltet das Laden von Schriftarten und die Abfrage ihres Downloadstatus.

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-Worker.

EventTarget FontFaceSet

Instanzeigenschaften

FontFaceSet.status Schreibgeschützt

Gibt den Ladezustand der Schriftart an. Es wird entweder 'loading' oder 'loaded' sein.

FontFaceSet.ready Schreibgeschützt

Promise, das aufgelöst wird, sobald Schriftladen und Layoutoperationen abgeschlossen sind.

FontFaceSet.size Schreibgeschützt

Gibt die Anzahl der Werte im FontFaceSet zurück.

Ereignisse

loading

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

loadingdone

Wird ausgelöst, wenn das Laden eines FontFace-Sets beendet ist.

loadingerror

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

Instanzmethoden

FontFaceSet.add()

Fügt dem Schrifensatz eine Schriftart hinzu.

FontFaceSet.check()

Ein Boolean-Wert, der angibt, ob eine Schriftart geladen ist, jedoch nicht das Laden initiiert, wenn sie nicht geladen ist.

FontFaceSet.clear()

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

FontFaceSet.delete()

Entfernt eine manuell hinzugefügte Schriftart aus dem Schrifensatz. CSS-verbundene Schriftarten 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 Schriftarten 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