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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
fonts

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch