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.
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.