Dokument: fonts-Eigenschaft

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.

Die fonts-Eigenschaft der Document-Schnittstelle gibt die FontFaceSet-Schnittstelle des Dokuments zurück.

Diese Funktion ist Teil der CSS Font Loading API.

Wert

Der zurückgegebene Wert ist die FontFaceSet-Schnittstelle des Dokuments. Die FontFaceSet-Schnittstelle ist nützlich zum Laden neuer Schriftarten, Überprüfen des Status von zuvor geladenen Schriftarten usw.

Beispiele

Ausführung nach dem Laden der Schriftarten

js
document.fonts.ready.then((fontFaceSet) => {
  // Any operation that needs to be done only after all used fonts
  // have finished loading can go here.
  const fontFaces = [...fontFaceSet];
  console.log(fontFaces);
  // some fonts may still be unloaded if they aren't used on the site
  console.log(fontFaces.map((f) => f.status));
});

Das Versprechen wird erfüllt, wenn die Lade- und Layout-Operationen aller verwendeten Schriftarten abgeschlossen sind. Die Menge der verwendeten Schriftarten kann von der Menge der deklarierten Schriftarten abweichen, z.B. wenn optionale Schriftarten (d.h. Schriftarten, die über font-display: optional deklariert sind) nicht rechtzeitig geladen werden konnten.

Spezifikationen

Specification
CSS Font Loading Module Level 3
# FontFaceSet-interface

Browser-Kompatibilität

Siehe auch