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.