CSS Font Loading API
The sizeAdjust property of the FontFace interface represents a multiplier for the font's glyph outlines and metrics, such as glyph widths and line heights, used to lay out text.
Different fonts can look larger or smaller at the same font size, because each font's glyphs are drawn at a different size relative to that font size.
The sizeAdjust property allows you to scale a font to match the apparent size of another font, such as a fallback font that is shown until a web font loads.
It is equivalent to the @font-face/size-adjust descriptor of @font-face.
Value
A string containing a non-negative percentage, such as "120%".
The default value is "100%", which leaves the font's glyph outlines and metrics unchanged.
This property accepts the same values as the @font-face/size-adjust descriptor.
Exceptions
SyntaxErrorDOMException- : Thrown when setting the property to a value that doesn't match the syntax of the @font-face/size-adjust descriptor, such as a negative percentage.
Examples
Setting the size adjustment
This example sets the size adjustment when constructing a font face, then updates it using the property.
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%"
Specifications
Browser compatibility
See also
- @font-face/size-adjust
- CSS Font Loading API
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
