<pre class="brush: css notranslate"><code><span class="token comment">/ Use the default settings /</span> <span class="token property">font-variation-settings</span><span class="token punctuation">:</span> normal<span class="token punctuation">;</span> <span class="token comment">/ Set values for OpenType axis names /</span> <span class="token property">font-variation-settings</span><span class="token punctuation">:</span> <span class="token string">"xhgt"</span> 0.7<span class="token punctuation">;</span> </code></pre>

font-variation-settings

The font-variation-settings CSS descriptor allows authors to specify low-level OpenType or TrueType font variations in the @font-face rule.

Syntax

/* Use the default settings */ font-variation-settings: normal;  /* Set values for OpenType axis names */ font-variation-settings: "xhgt" 0.7; 

Values

Text is laid out using default settings.

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 codepoint range, the whole property is invalid. The <number> can be fractional or negative.

Formal definition

Formal syntax

normal | [ <string> <number> ]#

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

See also

Last modified: Aug 12, 2021, by MDN contributors