База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / CSS

Потребителски CSS свойства и теми

Потребителските свойства съхраняват стойности, използвани от var(). Каскадата и наследяването позволяват споделяне на дизайнерски токени и локалното им предефиниране, например за тъмна тема.

Версия: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Синтаксис

--token: value;
property: var(--token);
property: var(--token, fallback);

Потребителското свойство има име, започващо с --, например --ink. Имената различават главни и малки букви: --ink и --Ink са различни. var(--ink) замества стойността му в стойността на друго свойство; не създава селектори или имена на свойства.

Нерегистрираните потребителски свойства участват в каскадата и се наследяват. Поставете споделените токени в :root, а предефиниранията за темата — върху контейнер. Наследниците получават предефинираните стойности, освен ако нямат собствени декларации. В примера .dark променя токените, докато правилото .card остава общо.

var(--space, 16px) използва резервната стойност, когато токенът липсва или има гарантирано невалидната стойност, например поради цикъл на зависимост. Не проверява дали съществуващ токен е подходящ за целевото свойство: --ink: 16px няма да задейства резервната стойност в color: var(--ink, black). Декларацията става невалидна при изчисляването на стойностите; за color това означава наследяване, а не връщане към по-ранна декларация в каскадата.

Примери

<!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>

Резултат

Light: black text on white; Dark: white text on black. Both cards: 16px padding on every side.

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници