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

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.

Fontes