CKTIS / CSS
Właściwości niestandardowe i motywy CSS
Właściwości niestandardowe przechowują wartości używane przez var(). Kaskada i dziedziczenie pozwalają współdzielić tokeny projektu oraz nadpisywać je lokalnie, na przykład dla ciemnego motywu.
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
--token: value;
property: var(--token);
property: var(--token, fallback);Właściwość niestandardowa ma nazwę zaczynającą się od --, np. --ink. Wielkość liter ma znaczenie: --ink i --Ink to różne nazwy. var(--ink) podstawia jej wartość do wartości innej właściwości; nie tworzy selektorów ani nazw właściwości.
Niezarejestrowane właściwości niestandardowe podlegają kaskadzie i są dziedziczone. Umieść wspólne tokeny w :root, a nadpisania motywu na kontenerze. Potomkowie odziedziczą nadpisane wartości, chyba że mają własne deklaracje. W przykładzie .dark zmienia tokeny, a reguła .card pozostaje wspólna.
var(--space, 16px) używa wartości zapasowej, gdy token nie istnieje lub ma specjalną wartość gwarantowanie niepoprawną, np. wskutek cyklu zależności. Nie sprawdza zgodności istniejącego tokenu z właściwością docelową: --ink: 16px nie uruchomi wartości zapasowej w color: var(--ink, black). Deklaracja stanie się niepoprawna podczas obliczania wartości; dla color oznacza to dziedziczenie, a nie powrót do wcześniejszej deklaracji z kaskady.
Przykłady
<!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>Wynik
Light: black text on white; Dark: white text on black. Both cards: 16px padding on every side.
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.