basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Палитра в CSS: токены по ролям для светлой и тёмной темы

    Цвета задаём один раз — переменными по ролям в :root, компоненты берут только var(--…). Тёмная тема — те же имена с другими значениями: включается по системной настройке или переключателем, а маленький скрипт в <head> ставит выбор до первой отрисовки. Разбираем по строкам файл токенов этого сайта.

    Как устроено

    Компоненты знают только имена: background: var(--raised), color: var(--ink-3). Значения лежат в одном файле в трёх местах: светлые — в :root, тёмные — для переключателя и для системной темы. Тема меняется подстановкой других значений под те же имена, CSS компонентов при этом не трогаем.

    Файл

    src/styles/tokens.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.