CKTIS / CSS
Propriedades personalizadas CSS: --*
As propriedades personalizadas armazenam valores em nomes que começam por --. Participam na cascata, são herdadas por predefinição e permitem que var() insira os seus valores nas declarações de outras propriedades.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
--name: <declaration-value>?;
property: var(--name, fallback);--* representa a família das propriedades personalizadas, não um nome literal de declaração. Utilize um identificador válido que comece por --, como --size; -- sozinho está reservado. Há distinção entre maiúsculas e minúsculas: --size e --Size são propriedades diferentes.
As propriedades personalizadas não registadas participam na cascata e são herdadas. Armazenam tokens CSS, que não são necessariamente valores válidos para a propriedade que os utiliza. var(--size, 20px) substitui pelo valor de --size; o valor alternativo aplica-se quando essa propriedade tem o valor garantidamente inválido, inclusive quando não existe nenhuma declaração que o forneça. Não corrige um valor existente que não seja adequado à propriedade que o utiliza: --size: red não ativa o valor alternativo para width.
O valor inicial de uma propriedade não registada é garantidamente inválido; initial repõe-no. Em contrapartida, a declaração vazia --size:; é um valor vazio válido. Referências cíclicas produzem valores inválidos. No exemplo, o primeiro retângulo herda 40px, enquanto o segundo utiliza o valor alternativo 20px depois de aplicar initial.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>Custom property inheritance</title>
<style>
.group { --size: 40px; }
.box {
width: var(--size, 20px);
height: 20px;
background: black;
margin-bottom: 4px;
}
.reset { --size: initial; }
</style>
<div class="group">
<div class="box"></div>
<div class="box reset"></div>
</div>Resultado
.box: width = 40px .box.reset: width = 20px
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.