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