Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

Proprietà personalizzate CSS e temi

Le proprietà personalizzate memorizzano valori usati da var(). Cascata ed ereditarietà permettono di condividere i token di design e sovrascriverli localmente, per esempio per creare un tema scuro.

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

Sintassi

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

Una proprietà personalizzata ha un nome che inizia con --, come --ink. I nomi distinguono tra maiuscole e minuscole: --ink e --Ink sono diversi. var(--ink) sostituisce il suo valore nel valore di un’altra proprietà; non crea selettori né nomi di proprietà.

Le proprietà personalizzate non registrate partecipano alla cascata e vengono ereditate. Inserisci i token condivisi in :root e le sovrascritture del tema su un contenitore. I discendenti ereditano i valori sovrascritti, a meno che non abbiano dichiarazioni proprie. Nell’esempio, .dark modifica i token mentre la regola .card resta condivisa.

var(--space, 16px) usa il valore di riserva quando il token manca o ha il valore garantito come non valido, per esempio a causa di un ciclo di dipendenze. Non controlla se un token esistente è adatto alla proprietà di destinazione: --ink: 16px non attiverà il valore di riserva in color: var(--ink, black). La dichiarazione diventa non valida al momento del calcolo dei valori; per color, questo significa ereditarietà, non il ritorno a una dichiarazione precedente nella cascata.

Esempi

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

Risultato

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

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