re:re:actable
Урок 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-переменные полезны для темизации.

Документация

MDN: Использование CSS-переменных, MDN: @property.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам