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.