FontFaceSet: load() Methode

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.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die load()-Methode des FontFaceSet erzwingt das Laden aller in den Parametern angegebenen Schriftarten.

Syntax

js
load(font)
load(font, text)

Parameter

font

eine Schriftangabe unter Verwendung der CSS-Wertsyntax, z.B. "italic bold 16px Roboto"

text

beschränkt die Schriftarten auf diejenigen, deren Unicode-Bereich mindestens eines der Zeichen im Text enthält. Dies prüft nicht die Abdeckung einzelner Glyphen.

Rückgabewert

Ein Promise, der mit einem Array von geladenen FontFace-Objekten erfüllt wird. Das Versprechen wird erfüllt, wenn alle Schriftarten geladen sind; es wird abgelehnt, wenn eine der Schriftarten nicht geladen werden konnte.

Beispiele

Das folgende Beispiel gibt ein Versprechen zurück, das je nach Erfolg des Ladens von "MyFont" erfüllt oder abgelehnt wird. Der Code in then() kann die Verfügbarkeit dieser Schriftart annehmen.

js
document.fonts.load("12px MyFont", "ß").then(/* ... */);

Spezifikationen

Specification
CSS Font Loading Module Level 3
# dom-fontfaceset-load

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
load

Legend

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

Full support
Full support