Урок 062 минуты чтения
Что такое CSS-переменные. Как объявить переменную в CSS?
На этой странице
Кратко
CSS-переменные или custom properties - это именованные значения, которые можно объявить в CSS и переиспользовать через функцию var().
Вопрос
Что такое CSS-переменные (custom properties)? Как их объявить, использовать и менять из JavaScript?
Главное
CSS-переменная начинается с двух дефисов.
:root {
--color-primary: #2563eb;
--space-md: 16px;
}
.button {
padding: var(--space-md);
background: var(--color-primary);
}:root часто используют для глобальных переменных.
Локальные переменные
Переменную можно объявить внутри конкретного блока.
.alert {
--alert-color: #b91c1c;
border-color: var(--alert-color);
color: var(--alert-color);
}Такая переменная доступна элементу и его потомкам.
Fallback
var() может иметь запасное значение.
.card {
border-radius: var(--radius-md, 8px);
}Если --radius-md не объявлена, будет использовано 8px.
Темизация
:root {
--page-bg: white;
--text-color: #111827;
}
[data-theme="dark"] {
--page-bg: #111827;
--text-color: white;
}
body {
background: var(--page-bg);
color: var(--text-color);
}CSS-переменные отлично подходят для тем, дизайн-токенов и переиспользуемых значений.
Что важно помнить
- Переменные живут в runtime и подчиняются каскаду: их можно переопределять в media queries, классах тем и компонентах.
- Из JS:
el.style.setProperty('--progress', '65%')иgetComputedStyle(el).getPropertyValue('--progress'). - Без регистрации переменная — просто строка, ее нельзя анимировать;
@propertyзадает тип, начальное значение и наследование. - Переменную нельзя использовать в селекторе или имени свойства, а в media query — только в container style queries.
- Невалидное значение переменной делает свойство «invalid at computed-value time» — оно станет
unset, а не возьмет предыдущее правило.
Мини-шпаргалка
- CSS-переменная начинается с
--. - Читать значение нужно через
var(--name). :rootиспользуют для глобальных токенов.- Переменные наследуются.
- В
var()можно указать fallback. - CSS-переменные полезны для темизации.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.