Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

Proprietà personalizzate CSS: --*

Le proprietà personalizzate memorizzano valori con nomi che iniziano con --. Partecipano alla cascata, vengono ereditate per impostazione predefinita e permettono a var() di inserire i loro valori nelle dichiarazioni di altre proprietà.

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

Sintassi

--name: <declaration-value>?;
property: var(--name, fallback);

--* indica la famiglia delle proprietà personalizzate, non un nome di dichiarazione letterale. Usa un identificatore valido che inizi con --, per esempio --size; -- da solo è riservato. La distinzione tra maiuscole e minuscole è significativa: --size e --Size sono proprietà diverse.

Le proprietà personalizzate non registrate partecipano alla cascata e vengono ereditate. Memorizzano token CSS, che non sono necessariamente valori validi per la proprietà che li usa. var(--size, 20px) sostituisce con il valore di --size; il valore di fallback si applica quando la proprietà ha il valore garantito come non valido, anche se nessuna dichiarazione lo specifica. Non corregge un valore esistente inadatto alla proprietà che lo usa: --size: red non attiva il fallback per width.

Il valore iniziale di una proprietà non registrata è garantito come non valido; initial lo ripristina. Al contrario, la dichiarazione vuota --size:; è un valore vuoto valido. I riferimenti ciclici producono valori non validi. Nell’esempio, il primo rettangolo eredita 40px, mentre il secondo usa il fallback 20px dopo l’applicazione di initial.

Esempi

<!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>

Risultato

.box: width = 40px
.box.reset: width = 20px

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti