Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła