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

CKTIS / CSS

Propriedades personalizadas CSS e temas

As propriedades personalizadas armazenam valores usados por var(). A cascata e a herança permitem partilhar tokens de design e substituí-los localmente, por exemplo, para criar um tema escuro.

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

Sintaxe

--token: value;
property: var(--token);
property: var(--token, fallback);

Uma propriedade personalizada tem um nome iniciado por --, como --ink. Os nomes distinguem maiúsculas de minúsculas: --ink e --Ink são diferentes. var(--ink) substitui o seu valor no valor de outra propriedade; não cria seletores nem nomes de propriedades.

As propriedades personalizadas não registadas participam na cascata e são herdadas. Coloque os tokens partilhados em :root e as substituições do tema num contentor. Os descendentes herdam os valores substituídos, salvo se tiverem declarações próprias. No exemplo, .dark altera os tokens, enquanto a regra .card permanece partilhada.

var(--space, 16px) utiliza o valor alternativo quando o token não existe ou tem o valor garantidamente inválido, por exemplo, devido a um ciclo de dependências. Não verifica se um token existente é adequado à propriedade de destino: --ink: 16px não faz com que seja usado o valor alternativo em color: var(--ink, black). A declaração torna-se inválida no momento do cálculo dos valores; para color, isto significa herança, não o regresso a uma declaração anterior na cascata.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Custom properties</title>
<style>
  :root {
    --surface: white;
    --ink: black;
  }
  .dark {
    --surface: black;
    --ink: white;
  }
  .card {
    background-color: var(--surface);
    color: var(--ink);
    padding: var(--space, 16px);
  }
</style>
<div class="card">Light</div>
<section class="dark">
  <div class="card">Dark</div>
</section>
</html>

Resultado

Light: black text on white; Dark: white text on black. Both cards: 16px padding on every side.

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