Document: 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 zuvor geladener Schriftarten etc.

Beispiele

Durchführung einer Operation, nachdem die Schriftarten geladen sind

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 Lade- und Layout-Operationen aller verwendeten Schriftarten abgeschlossen sind. Der Satz der verwendeten Schriftarten kann sich von dem der deklarierten Schriftarten unterscheiden, 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

BCD tables only load in the browser

Siehe auch