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.

We’d love to hear your thoughts on the next set of proposals for the JavaScript language. You can find a description of the proposals here.
Please take two minutes to fill out our short survey.

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