CKTIS / CSS
Vlastné vlastnosti CSS a témy
Vlastné vlastnosti ukladajú hodnoty používané funkciou var(). Kaskáda a dedenie umožňujú zdieľať návrhové tokeny a lokálne ich prepisovať, napríklad pri vytváraní tmavej témy.
Verzia: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
--token: value;
property: var(--token);
property: var(--token, fallback);Vlastná vlastnosť má názov začínajúci na --, napríklad --ink. Pri názvoch záleží na veľkosti písmen: --ink a --Ink sú rozdielne. var(--ink) dosadí jej hodnotu do hodnoty inej vlastnosti; nevytvára selektory ani názvy vlastností.
Neregistrované vlastné vlastnosti sa zúčastňujú kaskády a dedia sa. Zdieľané tokeny umiestnite do :root a prepísania témy na kontajner. Potomkovia dedia prepísané hodnoty, pokiaľ nemajú vlastné deklarácie. V príklade .dark mení tokeny, zatiaľ čo pravidlo .card zostáva spoločné.
var(--space, 16px) použije náhradnú hodnotu, keď token chýba alebo má zaručene neplatnú hodnotu, napríklad pre cyklus závislostí. Nekontroluje, či existujúci token zodpovedá cieľovej vlastnosti: --ink: 16px neaktivuje náhradnú hodnotu v color: var(--ink, black). Deklarácia sa stane neplatnou v čase výpočtu hodnôt; pri color to znamená dedenie, nie návrat k skoršej deklarácii v kaskáde.
Príklady
<!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>Výsledok
Light: black text on white; Dark: white text on black. Both cards: 16px padding on every side.
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.