FontFace: Eigenschaft sizeAdjust
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die Eigenschaft sizeAdjust der Schnittstelle FontFace gibt einen Multiplikator für die Umrisse und Metriken der Glyphen einer Schriftart an, beispielsweise für Glyphenbreiten und Zeilenhöhen. Diese Werte werden für das Layout von Text verwendet.
Verschiedene Schriftarten können bei derselben Schriftgröße größer oder kleiner wirken, da die Glyphen jeder Schriftart im Verhältnis zur Schriftgröße unterschiedlich groß gezeichnet werden. Mit der Eigenschaft sizeAdjust können Sie eine Schriftart skalieren, sodass ihre wahrgenommene Größe der einer anderen Schriftart entspricht – beispielsweise einer Ersatzschriftart, die angezeigt wird, bis eine Webschriftart geladen ist.
Sie entspricht dem Deskriptor size-adjust von @font-face.
Wert
Eine Zeichenfolge mit einem nicht negativen Prozentwert, beispielsweise "120%". Der Standardwert ist "100%". Bei diesem Wert bleiben die Umrisse und Metriken der Glyphen unverändert.
Diese Eigenschaft akzeptiert dieselben Werte wie der Deskriptor size-adjust.
Ausnahmen
SyntaxErrorDOMException-
Wird ausgelöst, wenn die Eigenschaft auf einen Wert gesetzt wird, der nicht der Syntax des Deskriptors
size-adjustentspricht, beispielsweise auf einen negativen Prozentwert.
Beispiele
Größenanpassung festlegen
In diesem Beispiel wird die Größenanpassung beim Erstellen einer Schriftart festgelegt und anschließend über die Eigenschaft aktualisiert.
const fontFace = new FontFace(
"Roboto",
'url("https://fonts.example.com/roboto.woff2")',
{
sizeAdjust: "120%",
},
);
console.log(fontFace.sizeAdjust); // "120%"
fontFace.sizeAdjust = "100%";
console.log(fontFace.sizeAdjust); // "100%"