Как устроено
Компоненты знают только имена: background: var(--raised), color: var(--ink-3). Значения лежат в одном
файле в трёх местах: светлые — в :root, тёмные — для переключателя и для системной темы. Тема меняется
подстановкой других значений под те же имена, CSS компонентов при этом не трогаем.
Файл
:root {
color-scheme: light;
--ground: #f4f2ee;
--raised: #ffffff;
--sunken: #f0ece5;
--ink: #1a1816;
--ink-2: #4a4540;
--ink-3: #66605a;
--line: #e3ded5;
--line-strong: #d3ccc0;
}Имена — по роли: фон страницы, карточка, поле; три уровня текста; линии. Считаем пары, а не цвета: --ink-3 на --ground — 5,55:1, на --raised — 6,20:1, на --sunken — 5,27:1, и подпись проходит AA на любом фоне сайта. color-scheme: light говорит браузеру, что его поля и полосы прокрутки — светлые.
по умолчанию:color-scheme normal
:root {
--accent: #cc3f23;
--accent-hover: #b73519;
--accent-ink: #bc3a1f;
--accent-soft: rgba(204, 63, 35, 0.09);
--on-accent: #ffffff;
}Один акцент — пять ролей. --accent — заливка кнопки, белый текст на ней — 4,88:1. Тот же цвет текстом по фону #f4f2ee — 4,37:1, мимо AA, поэтому у ссылок свой --accent-ink, чуть темнее: 4,99:1. --accent-soft — подложка в 9%, --on-accent — текст на заливке: в тёмной теме он станет тёмным.
:root {
--ok: #2e7d4f;
--ok-soft: rgba(46, 125, 79, 0.1);
--warn: #9a4e0a;
--warn-soft: rgba(240, 160, 40, 0.14);
--on-warn: #ffffff;
}Состояния. --ok на фоне — 4,51:1, на сотую выше порога; --warn — 5,42:1, белый текст на нём — 6,06:1. Бледные -soft — подложки под блоки, текст на них остаётся обычным --ink.
:root[data-theme='dark'] {
color-scheme: dark;
--ground: #131210;
--raised: #1f1d1a;
--ink: #f2eee8;
--ink-3: #a39b90;
--accent: #ff7a55;
--accent-ink: #ff9473;
--on-accent: #1a0d08;
/* … остальные токены — те же имена */
}Выбор переключателя — атрибут data-theme на <html>. Имена те же, значения подобраны заново: фон не чёрный и текст не белый — 16,2:1, подписи #a39b90 — 6,82:1. Прежний акцент #cc3f23 на тёмном фоне дал бы 3,84:1, новый #ff7a55 — 7,28:1. Белый текст на нём — 2,57:1, поэтому --on-accent тёмный: 7,39:1.
@media (prefers-color-scheme: dark) {
:root:not([data-theme='light']) {
color-scheme: dark;
--ground: #131210;
/* … тот же тёмный набор целиком */
}
}Системная тема — пока переключателем не выбрана светлая. Без :not([data-theme='light']) тёмная система перекрыла бы выбор. Цена — тёмный набор записан в файле дважды, и тёмный цвет правим в двух местах.
:root {
color-scheme: light dark;
--ground: light-dark(#f4f2ee, #131210);
--ink: light-dark(#1a1816, #f2eee8);
--accent: light-dark(#cc3f23, #ff7a55);
}
:root[data-theme='light'] {
color-scheme: light;
}
:root[data-theme='dark'] {
color-scheme: dark;
}Вариант без повтора: light-dark() берёт первое значение при светлой схеме и второе — при тёмной, а схему задаёт color-scheme — по системе или переключателем. Каждый цвет — одной строкой; Chrome 123, Firefox 120, Safari 17.5. На этом сайте его нет: часть тёмных значений — не цвета. Тени в тёмной теме другой формы, кольцо 0 0 0 1px вместо мягкой тени, а --when-dark переключает display; light-dark() выбирает только цвет или картинку.
Выбор — до первой отрисовки
<script>
try {
const theme = localStorage.getItem('theme');
if (theme === 'light' || theme === 'dark') document.documentElement.dataset.theme = theme;
} catch {}
</script>
Скрипт стоит в <head> и он обычный — не модуль и без defer: браузер выполняет его, пока разбирает
<head>, и страница сразу рисуется в выбранной теме. В Astro такой скрипт пишут с is:inline, иначе Astro
соберёт его в модуль, и он выполнится после отрисовки. try нужен на случай, когда сайту запрещено хранить
данные: тогда обращение к localStorage бросает ошибку. Переключатель пишет выбор в localStorage.theme
и ставит тот же атрибут; без выбора атрибута нет, и тему решает система.
Цвет панели браузера на телефоне задаёт HTML, переменные CSS туда не доходят — это единственные hex-значения сайта вне файла токенов:
<meta name="theme-color" media="(prefers-color-scheme: light)" content="#F4F2EE" />
<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#131210" />
Как проверить
- DevTools, панель Rendering, Emulate CSS media feature prefers-color-scheme: dark — сайт темнеет без переключателя. Выбираем переключателем светлую — сайт остаётся светлым и при тёмной эмуляции.
- Пипеткой DevTools проверяем контраст каждого токена текста в обеих темах («Контраст текста»).
Hex вне файла токенов ищем так — здесь находятся только две строки theme-color, всё остальное было бы
цветом мимо палитры:
grep -rnE '#[0-9a-fA-F]{3,8}' src --include=*.css --include=*.astro | grep -v tokens.css
Если не работает
Переключили тему, а часть элементов осталась светлой
- Причина
- В компоненте цвет записан hex-значением, а не токеном, и тёмный набор его не меняет.
- Делаем
- Ищем hex вне файла токенов —
grep -rnE '#[0-9a-fA-F]{3,8}' src --include=*.css --include=*.astro | grep -v tokens.css— и заменяем наvar(--…).
Выбрали светлую тему, а при тёмной системной сайт всё равно тёмный
- Причина
- Тёмный набор в
@media (prefers-color-scheme: dark)стоит на голом:rootи перекрывает выбор переключателя. - Делаем
- Условие
:root:not([data-theme='light']): системная тема действует, пока не выбрана светлая.
При каждом переходе по сайту тёмная тема мигает светлой
- Причина
- Выбор из
localStorageчитает скрипт в конце<body>, сdeferили модулем — страница успевает отрисоваться светлой. - Делаем
- Скрипт — в
<head>, обычный, безdeferиtype=module: он выполняется до первой отрисовки. В Astro —<script is:inline>.
light-dark() всегда отдаёт светлое значение
- Причина
- У элемента нет
color-schemeсdark: функция смотрит на него, а не на системную тему напрямую. - Делаем
color-scheme: light darkу:root; переключатель меняетcolor-schemeнаlightилиdark.