Тёмный режим включён у многих пользователей телефонов и компьютеров, и браузер сообщает об этом сайту через медиазапрос 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]. По умолчанию разумно следовать системе - это то, что пользователь уже выбрал.
Как проверять
- В DevTools во вкладке Rendering эмулируйте prefers-color-scheme: dark и пройдите все типы страниц.
- Проверьте контраст текста, ссылок, рамок полей и иконок-кнопок в обеих темах.
- Добавьте скриншот-тесты в двух темах: на этом сайте каждая страница снимается в 375 и 1440 пикселей, светлой и тёмной, и любое расхождение видно до выкладки.
Про цвета, типографику и компоненты как систему - в статье дизайн-система сайта. Если нужно добавить тёмную тему существующему сайту, опишите задачу на странице контакты.
Первоисточники
prefers-color-scheme - MDN, color-scheme - MDN, WCAG 2.2: контраст текста 1.4.3 и контраст элементов интерфейса 1.4.11, viewport и themeColor в Next.js.