Тёмный режим включён у многих пользователей телефонов и компьютеров, и браузер сообщает об этом сайту через медиазапрос prefers-color-scheme. Сделать тёмную тему несложно, если с первого дня описывать цвета смыслом, а не значением. Разберём на примере палитры этого сайта.

Токены вместо цветов

В компонентах не должно быть #ffffff или #16193a. Вместо них - переменные со смыслом: фон страницы, поверхность карточки, основной текст, вторичный текст, линия, акцент. Тёмная тема переопределяет значения переменных в одном месте, а компоненты остаются прежними:

JavaScript:root { --paper: #f6f6fd; /* фон страницы */ --surface: #ffffff; /* карточки */ --ink: #16193a; /* основной текст */ --accent: #3a35e8; /* кнопки и ссылки */ color-scheme: light dark; } @media (prefers-color-scheme: dark) { :root { --paper: #11132b; --surface: #191c3d; --ink: #eceeff; --accent: #8a86ff; } } body { background: var(--paper); color: var(--ink); }

Свойство color-scheme сообщает браузеру, какие схемы поддерживает страница. Тогда поля ввода, выпадающие списки, полосы прокрутки и встроенный календарь тоже становятся тёмными, и не нужно перекрашивать каждый из них вручную.

Контраст: фирменный цвет не всегда подходит

Требования WCAG одинаковы для обеих тем: обычный текст - не ниже 4,5:1, крупный текст и элементы интерфейса - 3:1. Цвет, который отлично работает на светлом фоне, на тёмном может провалиться. Пример с этого сайта:

  • Кобальт #3a35e8 на светлом фоне #f6f6fd - 6,84:1, подходит для текста и ссылок.
  • Тот же кобальт на тёмном фоне #11132b - 2,48:1, не проходит даже для крупного текста.
  • Светлый оттенок #a7a4ff на тёмном фоне - 8,16:1: именно он используется для ссылок в тёмной теме.

Поэтому у каждого фирменного цвета две роли: заливка (кнопки, полосы, плашки) и текст. Для текста подбирается свой оттенок в каждой теме. Мятный #2fd3a0 на белом даёт лишь 1,92:1 - он годится для заливки, а текст того же направления набран тёмным #0b7556 с контрастом 5,69:1.

Цвет интерфейса браузера

Мета-тег theme-color окрашивает адресную строку мобильного браузера. Его можно задать отдельно для каждой темы:

JavaScript<meta name="theme-color" media="(prefers-color-scheme: light)" content="#f6f6fd"> <meta name="theme-color" media="(prefers-color-scheme: dark)" content="#11132b">

В Next.js App Router это делается через экспорт viewport с полем themeColor - массивом с медиазапросами, и фреймворк сам выведет оба тега.

Изображения и логотипы

  • Иконки и простые логотипы в SVG рисуйте через currentColor - они примут цвет текста в любой теме.
  • Для сложного логотипа или схемы подготовьте тёмный вариант и подключите через picture с source media="(prefers-color-scheme: dark)".
  • Фотографии оставьте как есть, но избегайте чисто белых рамок и подложек вокруг них: на тёмном фоне они слепят.

Ручной переключатель без мигания

Если на сайте есть переключатель темы, выбор хранится в localStorage и применяется атрибутом на html. Скрипт должен выполниться до первой отрисовки - небольшим встроенным блоком в head, иначе посетитель на мгновение увидит светлую тему:

TSX<script> // Выполняется до отрисовки: сохранённая тема применяется без мигания try { const saved = localStorage.getItem('theme') if (saved === 'light' || saved === 'dark') { document.documentElement.dataset.theme = saved } } catch {} </script>

В CSS тогда нужны три состояния: системное (медиазапрос), принудительно светлое и принудительно тёмное через [data-theme]. По умолчанию разумно следовать системе - это то, что пользователь уже выбрал.

Как проверять

  1. В DevTools во вкладке Rendering эмулируйте prefers-color-scheme: dark и пройдите все типы страниц.
  2. Проверьте контраст текста, ссылок, рамок полей и иконок-кнопок в обеих темах.
  3. Добавьте скриншот-тесты в двух темах: на этом сайте каждая страница снимается в 375 и 1440 пикселей, светлой и тёмной, и любое расхождение видно до выкладки.

Про цвета, типографику и компоненты как систему - в статье дизайн-система сайта. Если нужно добавить тёмную тему существующему сайту, опишите задачу на странице контакты.

Первоисточники

prefers-color-scheme - MDN, color-scheme - MDN, WCAG 2.2: контраст текста 1.4.3 и контраст элементов интерфейса 1.4.11, viewport и themeColor в Next.js.

Вопросы по теме

Нужна ли тёмная тема корпоративному сайту?
Многие посетители включают тёмный режим в системе, особенно на телефонах вечером. Сайт, который его игнорирует, выглядит чужеродно рядом с остальными приложениями. Если стили построены на токенах, тёмная тема - это в основном второй набор значений и проверка контраста.
Можно ли просто инвертировать цвета фильтром?
Нет: фильтр invert переворачивает и фотографии, и логотипы, ломает фирменные цвета и тени. Тёмную тему проектируют как самостоятельную палитру с проверенным контрастом.