Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

font-variation-settings — eixos de tipos de letra variáveis

A propriedade font-variation-settings permite controlar, a baixo nível, os eixos de tipos de letra variáveis através de etiquetas associadas a valores numéricos.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

font-variation-settings: normal | [ <opentype-tag> <number> ]#;

font-variation-settings aceita normal ou pares etiqueta-número separados por vírgulas. É herdada; o valor inicial normal significa que esta propriedade não provoca alterações.

Uma etiqueta é uma cadeia com exatamente quatro caracteres ASCII no intervalo U+0020–U+007E. Distingue maiúsculas de minúsculas. Os números podem ser negativos ou fracionários. Os eixos não suportados são ignorados; os valores fora do intervalo de um eixo são limitados ao valor suportado mais próximo.

Prefira font-weight para wght, font-style para slnt/ital e font-optical-sizing para opsz. Para wdth, use font-width, o nome definido em CSS Fonts Level 4. Por razões de compatibilidade, declare primeiro font-stretch com o mesmo valor: os navegadores que só suportam font-stretch ignoram font-width. A lista de baixo nível é substituída na totalidade, não é combinada eixo a eixo.

O exemplo verifica valores calculados sem um tipo de letra externo. Para que a alteração seja visível, é necessário um tipo de letra que suporte o eixo especificado.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>font-variation-settings</title>
<style>
  #sample { font-variation-settings: "wght" 650; }
  #sample span { font-variation-settings: normal; }
</style>
<p id="sample">Axis setting <span>Reset</span></p>
<pre id="result"></pre>
<script>
  const sample = document.querySelector('#sample');
  const child = sample.querySelector('span');
  document.querySelector('#result').textContent = [
    getComputedStyle(sample).fontVariationSettings,
    getComputedStyle(child).fontVariationSettings
  ].join('\n');
</script>

Resultado

"wght" 650
normal

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes