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.