Гайды

Как добавить тёмную тему на сайт — за 4 шага (без ручной перекраски)

Иллюстрация: один тумблер переключает весь экран со светлого на тёмный

«Тёмная тема» звучит как адский труд: пройти по каждой кнопке, каждому блоку и перекрасить вручную. Хорошая новость — так её никто не делает. Секрет в том, что цвета описываются один раз через переменные, а переключатель просто меняет их значения разом. Ниже — четыре шага, после которых тема переключается одной кнопкой. И готовый промпт, чтобы ИИ собрал это за тебя.

Шаг 1. Вынеси цвета в переменные

Перестань писать цвета прямо в стилях (color: #fff). Собери их в одном месте — в CSS-переменных на корне страницы:

:root {
  --bg: #ffffff;
  --text: #141416;
}
body {
  background: var(--bg);
  color: var(--text);
}

Теперь весь сайт берёт цвета из двух переменных, а не из сотни хардкодов. Это вся подготовка.

Шаг 2. Опиши тёмный набор одним переключателем

Добавь второй набор тех же переменных — он включается, когда на странице стоит атрибут data-theme="dark":

[data-theme="dark"] {
  --bg: #141416;
  --text: #f4f4f4;
}

Больше ничего перекрашивать не нужно. Меняется атрибут — меняются переменные — весь сайт перекрашивается сам. Вот тут и живёт вся магия.

Шаг 3. Повесь кнопку-переключатель

Кнопке нужно одно действие: поставить или снять этот атрибут на <html>.

<button id="theme">🌙</button>
<script>
  document.getElementById('theme').onclick = () => {
    const el = document.documentElement;
    const dark = el.getAttribute('data-theme') === 'dark';
    el.setAttribute('data-theme', dark ? 'light' : 'dark');
  };
</script>

Жми кнопку — тема переключается. Уже рабочий минимум.

Шаг 4. Запомни выбор и уважай систему

Осталось две мелочи, которые отличают поделку от нормальной темы:

  • Запомнить выбор, чтобы после перезагрузки тема не слетала, — сохраняем в localStorage.
  • Уважать системную тему — если у человека телефон в тёмном режиме, покажи тёмную сразу.
// при клике — сохраняем выбор:
localStorage.setItem('theme', dark ? 'light' : 'dark');

// при загрузке страницы — восстанавливаем:
const saved = localStorage.getItem('theme');
const prefersDark = matchMedia('(prefers-color-scheme: dark)').matches;
document.documentElement.setAttribute('data-theme', saved ?? (prefersDark ? 'dark' : 'light'));

Что получится

Кнопка, которая мгновенно переключает светлую и тёмную тему на всём сайте, помнит выбор между визитами и с первого раза попадает в системные настройки человека. И всё это — на двух наборах переменных, без единой ручной перекраски элементов.

Попроси ИИ — но правильно

Это идеальная задача, чтобы отдать ИИ. Только не проси «сделай тёмную тему» — получишь кашу. Дай ему тот самый план:

Слабый промптДобавь на мой сайт тёмную тему
Сильный промпт

Разница в том, что второй промпт задаёт архитектуру — и ИИ не выдумывает свою кривую. Про то, как вообще формулировать такие задачи, есть как написать хороший промпт.

Частая засада: картинки, тени и рамки

Переменные перекрасят фон и текст, но пару вещей легко забыть — и они выдают недоделку:

  • Картинки и логотипы. Чёрный логотип на тёмном фоне пропадёт. Держи светлую версию под тёмную тему или добавь ему лёгкую подложку.
  • Тени. Мягкая серая тень, красивая на белом, на тёмном фоне превращается в грязное пятно. В тёмной теме тени обычно делают едва заметными или убирают вовсе.
  • Рамки и разделители. Светло-серые линии на тёмном исчезают. Заведи для них отдельную переменную --border и переопредели её в тёмном наборе.

Правило то же: любой цвет, который «выдаёт» тему, — в переменную, а не в хардкод.

Тёмная тема мигает белым при загрузке — почему?

Классическая беда: страница на миг показывает светлую тему, потом переключается. Причина — скрипт темы стоит внизу и срабатывает поздно. Лечится просто: выставляй data-theme в самом верху <head>, до отрисовки страницы. А если стили вообще не применяются, загляни в почему не работает CSS.

А если у меня сайт на React?

Идея та же — переменные и атрибут на <html> — но переключатель обычно вешают на состояние компонента. React как раз для этого удобен: меняешь состояние темы, а он проставляет атрибут. CSS-часть (переменные + [data-theme="dark"]) не меняется вообще.

Работает ли это на телефоне?

Да, prefers-color-scheme читает системную тему и на телефоне. Заодно проверь, что сам сайт нормально тянется на маленький экран — про это как сделать сайт адаптивным.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →