Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Dokument: fonts-Eigenschaft

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.

Die schreibgeschützte Eigenschaft fonts des Interfaces Document gibt das FontFaceSet des Dokuments zurück.

Diese Funktion ist Teil der CSS Font Loading API.

Wert

Der zurückgegebene Wert ist das FontFaceSet des Dokuments. Mit dem Interface FontFaceSet können Sie neue Schriftarten laden, den Status zuvor geladener Schriftarten prüfen usw.

Beispiele

Eine Operation ausführen, nachdem die Schriftarten geladen wurden

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 Promise wird erfüllt, wenn das Laden und die Layout-Berechnung für alle verwendeten Schriftarten abgeschlossen sind. Die Menge der verwendeten Schriftarten kann sich von der Menge der deklarierten Schriftarten unterscheiden, beispielsweise wenn optionale Schriftarten (also Schriftarten, die mit font-display: optional deklariert wurden) nicht rechtzeitig geladen werden konnten.

Spezifikationen

Spezifikation
CSS Font Loading Module Level 3
# FontFaceSet-interface

Browser-Kompatibilität

Siehe auch