CKTIS / CSS
Vlastní vlastnosti CSS a motivy
Vlastní vlastnosti ukládají hodnoty používané funkcí var(). Kaskáda a dědičnost umožňují sdílet návrhové tokeny a lokálně je přepisovat, například při vytváření tmavého motivu.
Verze: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
--token: value;
property: var(--token);
property: var(--token, fallback);Vlastní vlastnost má název začínající na --, například --ink. U názvů záleží na velikosti písmen: --ink a --Ink jsou různé. var(--ink) dosadí její hodnotu do hodnoty jiné vlastnosti; nevytváří selektory ani názvy vlastností.
Neregistrované vlastní vlastnosti se účastní kaskády a dědí se. Sdílené tokeny umístěte do :root a přepsání motivu na kontejner. Potomci přebírají přepsané hodnoty, pokud nemají vlastní deklarace. V příkladu .dark mění tokeny, zatímco pravidlo .card zůstává společné.
var(--space, 16px) použije náhradní hodnotu, když token chybí nebo má zaručeně neplatnou hodnotu, například kvůli cyklu závislostí. Nekontroluje, zda existující token odpovídá cílové vlastnosti: --ink: 16px náhradní hodnotu v color: var(--ink, black) neaktivuje. Deklarace se stane neplatnou při výpočtu hodnot; u color to znamená dědění, nikoli návrat k dřívější deklaraci v kaskádě.
Pří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ýsledek
Light: black text on white; Dark: white text on black. Both cards: 16px padding on every side.
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.