
Еще несколько лет назад реализация темной темы (или переключения между несколькими брендовыми темами) на сайте была головной болью. Разработчики либо дублировали CSS-файлы, либо использовали тяжелые JS-библиотеки, либо генерировали стили на лету через препроцессоры.
Сегодня, благодаря CSS-переменным (пользовательским свойствам CSS), темизация стала нативной, элегантной и невероятно гибкой задачей.
В этой статье мы разберем не просто «как поменять цвет фона», а как спроектировать правильную архитектуру переменных, которая позволит вашему проекту масштабироваться от простой светлой/темной темы до сложной мульти-брендинговой системы.
1. Почему именно CSS-переменные, а не SASS/LESS?
Прежде чем писать код, важно понять фундаментальную разницу между переменными в препроцессорах (SASS) и нативными CSS-переменными.
- SASS-переменные существуют только на этапе компиляции. После сборки в CSS остаются «мертвые» статические значения (например,
color: #333;). - CSS-переменные — это живые сущности в объектной модели документа (DOM). Они подчиняются правилам каскада, наследования и могут быть изменены во время выполнения (runtime) (в том числе через JavaScript или медиа-запросы) без перезагрузки страницы.
Именно эта «живучесть» делает CSS-переменные идеальным инструментом для темизации.
2. Архитектура: Примитивы и Семантика (Самое важное!)
Главная ошибка новичков — создание переменных вроде --blue или --black и использование их напрямую в компонентах. Если вы захотите сделать темную тему, вам придется переписывать каждый компонент.
Правильный подход делит переменные на два уровня:
Уровень 1: Примитивы (дизайн-токены)
Это ваша палитра, типографика и отступы. Они не зависят от темы.
:root {
/* Цветовая палитра */
--color-blue-500: #0052cc;
--color-blue-100: #e6f0ff;
--color-gray-900: #1a1a1a;
--color-gray-50: #f9f9f9;
--color-white: #ffffff;
/* Типографика и отступы */
--font-size-md: 16px;
--spacing-lg: 24px;
--radius-md: 8px;
}
Уровень 2: Семантические переменные (псевдонимы)
Эти переменные описывают назначение цвета, а не его значение. Именно их мы будем переопределять при смене темы.
:root {
/* Светлая тема (по умолчанию) */
--color-bg-primary: var(--color-white);
--color-bg-secondary: var(--color-gray-50);
--color-text-primary: var(--color-gray-900);
--color-brand-accent: var(--color-blue-500);
}
Правило золотого сечения: В ваших компонентах (кнопках, карточках, хедерах) должны использоваться только семантические переменные.
/* ПРАВИЛЬНО */
.button {
background-color: var(--color-brand-accent);
color: var(--color-bg-primary);
}
/* НЕПРАВИЛЬНО */
.button {
background-color: var(--color-blue-500);
color: var(--color-white);
}
3. Базовая реализация: Светлая и Темная тема
Теперь, когда у нас есть семантическая база, переключение темы сводится к переопределению этих переменных. Лучше всего использовать атрибут data-theme на теге <html> или <body>.
/* Базовые примитивы (общие для всех тем) */
:root {
--color-blue-500: #0052cc;
--color-gray-900: #1a1a1a;
--color-gray-50: #f4f4f5;
--color-white: #ffffff;
}
/* Светлая тема */
:root {
--color-bg-primary: var(--color-white);
--color-bg-secondary: var(--color-gray-50);
--color-text-primary: var(--color-gray-900);
--color-brand-accent: var(--color-blue-500);
}
/* Темная тема */
[data-theme="dark"] {
--color-bg-primary: var(--color-gray-900);
--color-bg-secondary: #2a2a2a;
--color-text-primary: var(--color-gray-50);
--color-brand-accent: #4d94ff; /* Чуть светлее для контраста на темном фоне */
}
4. Уважение к пользователю: Системные настройки
Современные пользователи ожидают, что сайт подстроится под их ОС. Мы можем сделать темную тему дефолтной, если в системе выбрана темная тема, используя медиа-запрос.
/* Если в системе темная тема, применяем темные семантические переменные */
@media (prefers-color-scheme: dark) {
:root {
--color-bg-primary: var(--color-gray-900);
--color-bg-secondary: #2a2a2a;
--color-text-primary: var(--color-gray-50);
--color-brand-accent: #4d94ff;
}
}
5. Ручное переключение тем (JavaScript + LocalStorage)
Системные настройки — это хорошо, но пользователь должен иметь возможность переопределить их вручную (например, читать статьи в темной теме днем, даже если в системе стоит светлая).
HTML
<button id="theme-toggle" aria-label="Переключить тему">
Сменить тему
</button>
JavaScript
const themeToggle = document.getElementById('theme-toggle');
// 1. Функция применения темы
function setTheme(theme) {
document.documentElement.setAttribute('data-theme', theme);
localStorage.setItem('theme', theme);
}
// 2. Инициализация при загрузке
// Приоритет: LocalStorage -> Системные настройки -> Светлая тема
function initTheme() {
const savedTheme = localStorage.getItem('theme');
if (savedTheme) {
setTheme(savedTheme);
} else {
const systemPrefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
setTheme(systemPrefersDark ? 'dark' : 'light');
}
}
// 3. Обработчик клика
themeToggle.addEventListener('click', () => {
const currentTheme = document.documentElement.getAttribute('data-theme');
const newTheme = currentTheme === 'dark' ? 'light' : 'dark';
setTheme(newTheme);
});
// Запускаем
initTheme();
Совет (Избегаем FOUC): FOUC (Flash of Unstyled Content) — это «вспышка нестилизованного контента». Чтобы страница не «мигала» светлой темой перед применением темной при загрузке, вставьте небольшой блокирующий скрипт прямо в <head> (до загрузки основных CSS/JS), который будет считывать localStorage и сразу ставить атрибут data-theme на <html>.
6. Продвинутый уровень: Локальная темизация (область видимости)
CSS-переменные наследуются. Это означает, что вы можете создать «карман» с другой темой внутри любой части сайта, просто переопределив переменные на родительском элементе.
Пример: У вас есть светлый сайт, но вам нужен промо-блок с темным фоном и светлым текстом.
/* Глобальная светлая тема */
:root {
--color-bg-primary: #ffffff;
--color-text-primary: #1a1a1a;
}
/* Локальная темная тема для конкретного блока */
.promo-section {
--color-bg-primary: #1a1a1a;
--color-text-primary: #ffffff;
/* Стили блока */
background-color: var(--color-bg-primary);
color: var(--color-text-primary);
padding: 40px;
}
/* Дочерние элементы автоматически подхватят новые значения! */
.promo-section h2 {
color: var(--color-text-primary);
}
Вам не нужно писать отдельные классы для заголовков внутри промо-блока. Каскад CSS сделает всю работу за вас.
7. Мульти-темизация: Больше, чем просто Dark/Light
Что если ваш сайт — это SaaS-платформа (программное обеспечение как услуга), и каждый корпоративный клиент хочет видеть свой брендинг? С CSS-переменными это делается за 5 минут.
/* Дефолтная тема */
:root {
--color-brand-accent: #0052cc;
}
/* Тема для клиента "A" */
[data-brand="client-a"] {
--color-brand-accent: #ff5722;
}
/* Тема для клиента "B" */
[data-brand="client-b"] {
--color-brand-accent: #009688;
}
Вся ваша инфраструктура (кнопки, ссылки, иконки, фокусы), которая использует var(--color-brand-accent), мгновенно перекрасится при смене атрибута data-brand на <body>.
8. Подводные камни и лучшие практики
Проблема прозрачности
Часто нужно применить цвет бренда, но с прозрачностью (например, для фона при наведении). CSS не умеет «на лету» разбивать шестнадцатеричный (HEX) формат на RGBA.
Решение: Храните цвета в формате RGB-каналов.
:root {
/* Храним каналы */
--color-brand-rgb: 0, 82, 204;
}
.button:hover {
/* Используем rgba() с переменной */
background-color: rgba(var(--color-brand-rgb), 0.1);
}
Альтернатива (современная): Использовать функцию color-mix() или относительные цвета в спецификации CSS Color Level 5, но поддержка RGB-каналов пока надежнее для кроссбраузерности.
Резервные значения
Всегда указывайте резервное значение на случай, если переменная не определена (например, при загрузке или в очень старых браузерах).
text {
color: var(--color-text-primary, #000000);
}
Не создавайте переменные для всего
Не стоит делать переменную для каждого отступа или размера шрифта, если они не меняются от темы. Переменные нужны для того, что должно меняться (цвета, тени, прозрачности, иногда — радиусы скругления). Базовые отступы лучше оставить в SASS/PostCSS или использовать стандартные CSS-значения.
Резюме
Использование CSS-переменных для темизации — это не просто тренд, а новый стандарт индустрии.
Чек-лист успешной темизации:
- Разделяйте переменные на примитивы (палитра) и семантику (назначение).
- Используйте только семантические переменные в компонентах.
- Применяйте
data-themeна<html>для управления темой. - Уважайте
prefers-color-scheme, но давайте пользователю приоритет черезlocalStorage. - Используйте наследование CSS для локальных инверсий цветов (темизация в ограниченной области видимости).
Внедрив этот подход один раз, вы навсегда закроете вопрос боли при добавлении новых тем, адаптации под новые бренды или создании доступных (accessibility) интерфейсов с высоким контрастом.