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.statusNur lesbar-
Gibt den Ladezustand des Font-Face an. Es wird entweder
'loading'oder'loaded'sein. FontFaceSet.readyNur lesbar-
Ein
Promise, der aufgelöst wird, sobald das Laden und die Layout-Operationen abgeschlossen sind. FontFaceSet.sizeNur lesbar-
Gibt die Anzahl der Werte im
FontFaceSetzurü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
FontFaceSetin Einfügereihenfolge zurück. FontFaceSet.forEach()-
Führt eine bereitgestellte Funktion für jeden Wert im
FontFaceSetObjekt aus. FontFaceSet.has()-
Gibt ein
Booleanzurück, das angibt, ob ein Element mit dem gegebenen Wert vorhanden ist. FontFaceSet.keys()-
Ein Alias für
FontFaceSet.values(). FontFaceSet.load()-
Gibt ein
Promisezurü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
FontFaceSetObjekt in Einfügereihenfolge liefert.
Spezifikationen
| Specification |
|---|
| CSS Font Loading Module Level 3 # FontFaceSet-interface |
Browser-Kompatibilität
BCD tables only load in the browser