Phone icon Связаться с нами

Веб-разработка

Что такое CSS-переменные?

CSS-переменные (custom properties, кастомные свойства) — это значения, которые объявляют один раз под именем с двумя дефисами, например —color-primary, и используют в стилях через функцию var(). Изменив переменную в одном месте, вы меняете её везде, где она используется.

Обычно переменные объявляют в селекторе :root — тогда они доступны на всей странице. Но их можно переопределять для отдельных блоков: внутри карточки или тёмной темы переменная будет иметь другое значение, а все стили, которые на неё ссылаются, автоматически подстроятся.

В отличие от переменных в препроцессорах вроде Sass, CSS-переменные живые: они работают в браузере, реагируют на медиазапросы и классы, и их можно менять из JavaScript во время работы страницы.

Где применяется

CSS-переменные используют для цветов бренда, отступов, размеров шрифтов и скруглений, светлой и тёмной тем, дизайн-систем и библиотек компонентов. Значения из Figma — цвета, отступы, шрифты — часто переносят в код именно в виде CSS-переменных.

Для фронтенд-разработчика переменные — способ держать стили упорядоченными: вместо двадцати одинаковых цветов, разбросанных по файлам, есть один источник правды. Это упрощает редизайн и поддержку нескольких тем.

Пример

Цвета и отступы вынесены в переменные, а тёмная тема лишь переопределяет их значения.

:root {
  --color-bg: #ffffff;
  --color-text: #0f172a;
  --color-primary: #2563eb;
  --space: 16px;
}

[data-theme="dark"] {
  --color-bg: #0f172a;
  --color-text: #e2e8f0;
}

body {
  background: var(--color-bg);
  color: var(--color-text);
}

.button {
  background: var(--color-primary);
  padding: var(--space) calc(var(--space) * 2);
}
Переменные в :root и их переопределение для тёмной темы.

CSS-переменные и переменные Sass: в чём разница

Переменные Sass существуют только во время сборки: препроцессор подставляет значения, и в готовом CSS их уже нет. CSS-переменные остаются в браузере, поэтому могут меняться в зависимости от класса, медиазапроса или действия пользователя. Sass удобен для вычислений во время сборки, CSS-переменные — для тем и динамических значений.

Частые вопросы

Как задать значение по умолчанию для переменной?

Вторым аргументом функции var(): var(—color-accent, #2563eb). Если переменная не объявлена, браузер использует запасное значение. Это полезно для компонентов, которые должны работать и без настроенной темы.

Можно ли менять CSS-переменные из JavaScript?

Да, методом style.setProperty, например document.documentElement.style.setProperty(‘—color-primary’, ‘#16a34a’). Все стили, которые используют переменную, обновятся сразу. Так делают переключатели тем и настройки интерфейса.

Поддерживают ли браузеры CSS-переменные?

Да, их поддерживают все современные браузеры. Проблемы возникали только в Internet Explorer, который давно не поддерживается Microsoft и на практике больше не учитывается.

Можно ли использовать переменные в медиазапросах?

Внутри медиазапросов переменные можно переопределять, но нельзя использовать как само условие: запись @media (min-width: var(—bp)) не сработает. Для контрольных точек обычно используют переменные препроцессора или настройки фреймворка.

Обучение фронтенд-разработке в OWU

Освойте фронтенд-разработку на практических курсах с менторами и реальными проектами.

Выбрать курс