basforge

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

    EN

    Цвет: палитра по ролям, контраст и тёмная тема

    Цвет на экране различает: уровни текста, ссылки, состояния, категории. Палитру собираем по ролям — фоны, три уровня текста, линии, один акцент, состояния, — у каждой пары текст–фон считаем контраст, тёмную тему подбираем отдельным набором тех же токенов, а смысл не держим на одном цвете.

    Какую задачу решает

    Цвет на странице делает три работы: разводит уровни — фон, текст, подписи; показывает состояние — ссылка, ошибка, успех; различает категории — линии графика, форматы материалов. Если подбирать цвета по месту, каждая работа идёт своим набором случайных оттенков, а тёмная тема превращается в переписывание всего CSS.

    Без системы

    • подписи серым на глаз: #999 на белом — 2,85:1
    • статус «ошибка» — только красная точка
    • кнопка green-500 с белым текстом — 2,28:1
    • тёмная тема — filter: invert(1)
    • hex-цвета прямо в компонентах

    С палитрой

    • цвета названы по роли: --ink-3, а не --gray-500
    • подписи #66605a — 5,6:1 к фону
    • статус — значок и слово, цвет добавляется к ним
    • тёмная тема — свой набор тех же токенов
    • в компонентах — только var(--…)

    Тон, насыщенность, светлота

    Экран смешивает красный, зелёный и синий — так и записан #cc3f23, акцент этого сайта. Глаз описывает цвет иначе: тон (красный, синий), насыщенность (яркий или приглушённый) и светлота. Для палитры главное — светлота: от неё зависит контраст, а тон в формулу контраста не входит («Контраст текста»).

    hsl() записывает цвет тоном, насыщенностью и светлотой, но его светлота — не та, что видит глаз. Жёлтый hsl(60 100% 50%) и синий hsl(240 100% 50%) — оба на 50%, а на белом фоне жёлтый даёт 1,07:1, синий — 8,59:1. В oklch() светлоту подогнали под восприятие: у того же жёлтого L — 96,8%, у синего — 45,2%. Ступени светлоты в OKLCH дают ступени яркости на глаз, и контраст от них меняется предсказуемо. В OKLCH задана, например, палитра Tailwind 4. oklch() работает во всех браузерах с мая 2023 года: Chrome 111, Firefox 113, Safari 15.4.

    Запись Пример Когда берём
    #rrggbb #cc3f23 готовая палитра из макета; так записаны токены этого сайта
    rgb() с прозрачностью rgb(204 63 35 / 0.09) подложка цвета акцента — здесь --accent-soft
    hsl() hsl(10 71% 47%) — тот же цвет, округлённо сдвинуть тон, не трогая остального; светлоте не верим
    oklch() oklch(56.9% 0.182 33.1) — тот же #cc3f23 палитра ступенями светлоты: 95%, 85% … 25%
    color-mix() color-mix(in srgb, var(--accent-ink) 35%, transparent) оттенок из токена без нового hex — так здесь подчёркнуты ссылки. Chrome 111, Firefox 113, Safari 16.2

    Из чего собрать палитру

    Роль Токены этого сайта Светлая тема Зачем отдельно
    фоны --ground, --raised, --sunken #f4f2ee, #ffffff, #f0ece5 страница, карточка над ней, поле внутри
    текст --ink, --ink-2, --ink-3 15,8:1, 8,5:1 и 5,6:1 к фону три уровня важности («Три уровня важности»)
    линии --line, --line-strong 1,34:1 и 1,59:1 к белому разделители между блоками. Порог 3:1 (WCAG 1.4.11) — для рамок, без которых не видно поле или кнопку
    акцент --accent, --accent-ink, --accent-soft, --on-accent заливка #cc3f23, текст #bc3a1f у заливки, текста и подложки свой контраст: #cc3f23 текстом по фону — 4,37:1, мимо AA
    состояния --ok, --warn #2e7d4f — 4,51:1, #9a4e0a — 5,42:1 успех и предупреждение, у каждого бледная подложка -soft

    Имена — по роли: --ink-3, а не --gray-500. В тёмной теме меняются значения, а имена и CSS компонентов остаются прежними. Акцент один: он работает, пока отличается от всего остального, — как жирный в тексте («Жирный — одно-два места»).

    Тёмная тема — свой набор

    Перевернуть светлую тему фильтром invert(1) не выходит: он переворачивает каждый канал, фото становятся негативом, а акцент #cc3f23 — голубым #33c0dc, тон уходит с 33° на 215°. Поэтому тёмная тема — те же токены с подобранными заново значениями:

    • Фон не чёрный, текст не белый: #f2eee8 на #131210 — 16,2:1. На белые буквы на чёрном часто жалуются люди с астигматизмом: буквы кажутся расплывчатыми («Контраст текста»).
    • На тёмном фоне тень почти не видна, и карточку отделяет светлота: --raised #1f1d1a светлее фона #131210.
    • Акцент светлеет. #cc3f23 на тёмном фоне — 3,84:1, мимо AA, поэтому здесь #ff7a55 — 7,28:1. Белый текст на нём — 2,57:1, и текст на акценте становится тёмным: #1a0d08, 7,39:1.
    • color-scheme: dark переключает то, что рисует сам браузер: поля ввода, полосы прокрутки, фон по умолчанию.

    Тема выбирается по системной настройке (prefers-color-scheme) и переключателем на сайте; как совместить одно с другим и не мигнуть белым при загрузке — «Палитра в CSS».

    Смысл — не только цветом

    Около 8% мужчин северноевропейского происхождения и меньше 1% женщин различают цвета хуже остальных, чаще всего — красный и зелёный; в азиатских и африканских популяциях это встречается реже. Цвет теряется и у остальных: на солнце, в ночном режиме экрана, на чёрно-белой распечатке. WCAG 1.4.1 (уровень A) требует, чтобы цвет не был единственным способом передать смысл.

    Цвет говорит Добавляем
    ошибка в поле текст ошибки под полем
    работает или упал значок и слово
    ссылка в тексте подчёркивание — здесь полупрозрачное, цветом акцента
    линии графика подпись у конца линии, разный пунктир
    текущий пункт меню вес шрифта или метку сбоку

    Проверяем в DevTools: панель Rendering (меню More tools), пункт Emulate vision deficiencies — протанопия, дейтеранопия, тританопия, ахроматопсия. В ахроматопсии страница серая: что различимо там — значком, словом, светлотой, — от цвета не зависит вовсе.

    Что получаем и чем платим

    Получаем

    • Тёмная тема — заменой значений. Компоненты пишут var(--ink), тёмная тема переопределяет токены, CSS компонентов не трогаем.
    • Контраст проверяют один раз. Пару --ink-3 на --raised посчитали — она та же во всех компонентах.
    • Случайный цвет находится поиском. Hex вне файла токенов значит, что кто-то обошёл палитру, — это ловит grep.
    • Палитру меняют в одном файле. Новый акцент — правка токенов, а не поиск по всем компонентам.

    Платим

    • Каждый цвет — дважды. Значение для светлой и для тёмной темы, и контраст каждой пары проверяем в обеих.
    • Тёмный набор записан дважды. Чтобы работали и системная тема, и переключатель, тёмные токены стоят и в [data-theme='dark'], и в @media (prefers-color-scheme: dark). light-dark() убирает повтор, но выбирает только между двумя цветами или картинками: тень другой формы им не задать («Палитра в CSS»).
    • Один акцент — мало выделений. Ссылка, кнопка и активный пункт одного цвета; различают их формой и весом.
    • oklch() и color-mix() старый браузер пропускает. Строку с непонятным значением CSS игнорирует целиком — нужен запасной hex строкой выше.

    С чего начать

    Если не работает

    В тёмной теме поля ввода и полосы прокрутки остались белыми

    Причина
    Нет color-scheme: dark: свои элементы браузер рисует светлыми, какой бы ни был фон страницы.
    Делаем
    color-scheme: dark в тёмном наборе токенов; если тема только по системе — color-scheme: light dark у :root.

    При загрузке страница вспыхивает белым, потом темнеет

    Причина
    Тему выбирает скрипт в конце страницы или после загрузки, и первая отрисовка — светлая.
    Делаем
    Выбор читаем маленьким скриптом в <head> и ставим data-theme на <html> до первой отрисовки. Системной теме скрипт не нужен — хватает @media (prefers-color-scheme: dark) («Палитра в CSS»).

    Красную и зелёную линии на графике путают

    Причина
    Самая частая цветовая слепота — красно-зелёная: оба цвета видны похожими.
    Делаем
    Подписываем линии у концов, даём им разный пунктир. Проверяем в DevTools: панель Rendering, Emulate vision deficiencies, дейтеранопия.

    Оттенки палитры с одной светлотой в HSL выглядят разной яркости

    Причина
    Светлота в hsl() не учитывает глаз: жёлтый и синий на 50% дают на белом 1,07:1 и 8,59:1.
    Делаем
    Палитру строим в oklch(): при одной L яркость на глаз близкая.

    После filter: invert(1) фото стали негативом, а оранжевый акцент — голубым

    Причина
    Фильтр переворачивает каждый канал: #cc3f23 становится #33c0dc.
    Делаем
    Тёмной теме — свой набор цветов («Палитра в CSS»), фильтр не используем.