The font-variation-settings CSS descriptor allows authors to specify low-level OpenType or TrueType font variations in the @font-face at-rule. The values for this descriptor are the same as the font-variation-settings property, except for the global keyword values.
Since this descriptor sets variation values on the font object in the @font-face at-rule and not on an entire element, only some glyphs in an element may be rendered using this descriptor.
Syntax
/* Use the default settings */
font-variation-settings: normal;
/* Set values for OpenType axis names */
font-variation-settings: "xhgt" 0.7;
Values
normal- : Text is laid out using default settings.
<string> <number>- : When rendering text, the list of OpenType axis names is passed to the text layout engine to enable or disable font features. Each setting is always a <string> of 4 ASCII characters, followed by a number indicating the axis value. If the
<string>has more or fewer characters or contains characters outside the U+20 - U+7E code point range, the whole property is invalid. The<number>can be fractional or negative.
- : When rendering text, the list of OpenType axis names is passed to the text layout engine to enable or disable font features. Each setting is always a <string> of 4 ASCII characters, followed by a number indicating the axis value. If the
Formal definition
Formal syntax
Examples
Setting font weight and stretch in a @font-face rule
@font-face {
font-family: "OpenTypeFont";
src: url("open_type_font.woff2") format("woff2");
font-weight: normal;
font-style: normal;
font-variation-settings:
"wght" 400,
"wdth" 300;
}
Specifications
Browser compatibility
See also
- Other
@font-facedescriptors: @font-face/font-display, @font-face/font-family, font-feature-settings, @font-face/font-stretch, @font-face/font-style, @font-face/font-weight, @font-face/src, @font-face/unicode-range - Related font properties: font-feature-settings, font-variation-settings
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
