Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

Właściwości niestandardowe CSS: --*

Właściwości niestandardowe przechowują wartości pod nazwami zaczynającymi się od --. Podlegają kaskadzie, domyślnie są dziedziczone, a var() pozwala wstawiać ich wartości do deklaracji innych właściwości.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

--name: <declaration-value>?;
property: var(--name, fallback);

--* oznacza rodzinę właściwości niestandardowych, a nie dosłowną nazwę deklaracji. Używaj poprawnego identyfikatora zaczynającego się od --, na przykład --size; samo -- jest zarezerwowane. Wielkość liter ma znaczenie: --size i --Size to różne właściwości.

Niezarejestrowane właściwości niestandardowe podlegają kaskadzie i są dziedziczone. Przechowują tokeny CSS, niekoniecznie poprawną wartość właściwości docelowej. var(--size, 20px) podstawia wartość --size; wartość zastępcza działa, gdy właściwość ma wartość gwarantowanie nieprawidłową, także wskutek braku deklaracji. Nie naprawia istniejącej wartości niepasującej do właściwości docelowej: --size: red nie uruchomi wartości zastępczej dla width.

Początkowa wartość niezarejestrowanej właściwości jest gwarantowanie nieprawidłowa; initial ją przywraca. Pusta deklaracja --size:; jest natomiast poprawną pustą wartością. Cykliczne odwołania powodują nieprawidłowe wartości. W przykładzie pierwszy prostokąt dziedziczy 40px, a drugi używa wartości zastępczej 20px po zastosowaniu initial.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>Custom property inheritance</title>
<style>
  .group { --size: 40px; }
  .box {
    width: var(--size, 20px);
    height: 20px;
    background: black;
    margin-bottom: 4px;
  }
  .reset { --size: initial; }
</style>
<div class="group">
  <div class="box"></div>
  <div class="box reset"></div>
</div>

Wynik

.box: width = 40px
.box.reset: width = 20px

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła