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

CKTIS / CSS

var() — substituição de uma propriedade personalizada

`var()` insere o valor calculado de uma propriedade personalizada noutra declaração, com segundo argumento opcional de reserva.

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

Sintaxe

var( <custom-property-name>, <declaration-value>? )

var() insere o valor calculado de uma propriedade personalizada noutra declaração, com segundo argumento opcional de reserva.

--step num cálculo dá largura 36px. var(--missing, var(--backup, 41px)) aninhado escolhe 27px; var(--bad, 41px), definido mas de tipo errado, não usa a reserva e a largura automática é 200px. A reserva vazia var(--missing,) é válida: true.

Gramática: var( <custom-property-name>, <declaration-value>? ).

Em var(--name, fallback), tudo após a primeira , pertence à reserva. Só é usada para variável ausente, cíclica ou garantidamente inválida, incluindo por initial; não valida a propriedade de destino. A substituição ocorre no valor calculado, por isso uma declaração inválida segue unset. Os nomes distinguem maiúsculas: --x e --X diferem.

Exemplos

const host=document.createElement('div');host.style.width='200px';document.body.append(host);
const box=style=>{const node=document.createElement('div');node.style.cssText=style;host.append(node);return getComputedStyle(node).width};
const resolved=box('--step:12px;width:calc(var(--step) * 3)');
const nested=box('--backup:27px;width:var(--missing,var(--backup,41px))');
const definedInvalid=box('--bad:red;width:var(--bad,41px)');
const emptyFallback=CSS.supports('width','var(--missing,)');
console.log('resolved='+resolved+'; nested='+nested+'; defined-invalid='+definedInvalid+'; empty-fallback-syntax='+emptyFallback);

Resultado

resolved=36px; nested=27px; defined-invalid=200px; empty-fallback-syntax=true

`var()` insere o valor calculado de uma propriedade personalizada noutra declaração, com segundo argumento opcional de reserva.

Fontes