v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T09:18:00.000Z▲ 0 upvotes

Темы на Tailwind и CSS-переменных без мигания при загрузке: 8 тем и SSR

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Откуда мигание

Пользователь выбрал тёмную тему, она сохранена в localStorage. При перезагрузке сервер отдаёт HTML без информации о теме — он не видит localStorage. Браузер рисует светлую страницу, затем загружается JavaScript, React гидратируется, useEffect читает настройку и переключает класс. Между первой отрисовкой и эффектом — заметная вспышка.

Чтобы её не было, тема должна быть применена до первой отрисовки. Есть два способа: синхронный скрипт в <head> или cookie, которую сервер читает при рендере.

Переменные для восьми тем

Каждая тема — набор значений одних и тех же переменных. Компоненты ссылаются только на семантические имена (--bg, --fg), а не на конкретные цвета:

/* app/themes.css */
:root, [data-theme="light"] {
  --bg: #ffffff; --surface: #f6f6f5; --fg: #1b1b1a; --muted: #6e6d68;
  --border: #e4e3df; --accent: #2457d6;
  color-scheme: light;
}
[data-theme="dark"] {
  --bg: #121211; --surface: #1b1b1a; --fg: #ececea; --muted: #a09f99;
  --border: #2b2b29; --accent: #6b8ff2;
  color-scheme: dark;
}
[data-theme="dracula"] {
  --bg: #282a36; --surface: #303241; --fg: #f8f8f2; --muted: #a4a7bd;
  --border: #44475a; --accent: #bd93f9;
  color-scheme: dark;
}
[data-theme="solarized-light"] {
  --bg: #fdf6e3; --surface: #eee8d5; --fg: #073642; --muted: #657b83;
  --border: #e0d9c3; --accent: #268bd2;
  color-scheme: light;
}
/* ...ещё четыре темы по той же схеме: nord, monokai, github-dark, one-light */

color-scheme важен: он переключает системные элементы (полосы прокрутки, нативные select, автозаполнение полей) в соответствующий режим. Без него на тёмной теме останутся светлые скроллбары.

Подключение к Tailwind v4

В Tailwind v4 тема задаётся в CSS. Директива @theme inline создаёт утилиты, которые ссылаются на ваши переменные, а не копируют значения:

/* app/globals.css */
@import "tailwindcss";
@import "./themes.css";

@theme inline {
  --color-bg: var(--bg);
  --color-surface: var(--surface);
  --color-fg: var(--fg);
  --color-muted: var(--muted);
  --color-border: var(--border);
  --color-accent: var(--accent);
}

@custom-variant dark (&:where([data-theme=dark], [data-theme=dark] *, [data-theme=dracula], [data-theme=dracula] *));

Теперь bg-bg, text-fg, border-border и модификаторы прозрачности вроде bg-accent/10 работают для всех тем сразу. Вариант dark: переопределён так, чтобы срабатывать на всех тёмных темах; перечислите их все. Если тёмные темы различаются только переменными, dark: может и не понадобиться.

Для Tailwind v3 то же делается в конфиге: переменные хранят каналы цвета, а в theme.extend.colors — bg: "rgb(var(--bg) / <alpha-value>)".

Скрипт до отрисовки

// app/layout.tsx
const THEMES = ["light", "dark", "dracula", "solarized-light", "nord", "monokai", "github-dark", "one-light"];

const themeScript = `(function(){try{
  var t = localStorage.getItem("theme");
  var allowed = ${JSON.stringify(THEMES)};
  if (allowed.indexOf(t) === -1) {
    t = window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
  }
  document.documentElement.setAttribute("data-theme", t);
}catch(e){}})();`;

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="ru" suppressHydrationWarning>
      <head>
        <script dangerouslySetInnerHTML={{ __html: themeScript }} />
      </head>
      <body className="bg-bg text-fg">{children}</body>
    </html>
  );
}

Ключевые моменты:

  • Скрипт инлайновый и синхронный, без async/defer, поэтому выполняется до отрисовки body.
  • suppressHydrationWarning на <html>: сервер отрендерил элемент без data-theme, а клиент видит атрибут. Подавление действует только на атрибуты этого элемента, не на дочерние.
  • Значение из localStorage сверяется со списком: иначе туда можно записать строку, которая сломает селекторы.
  • try/catch, потому что доступ к localStorage бросает исключение в некоторых режимах приватности.

Если на сайте строгая CSP, инлайновому скрипту нужен nonce или хеш. Библиотека next-themes делает то же самое и умеет работать с несколькими темами через attribute="data-theme" и список themes.

Переключатель

"use client";
export function ThemeSelect({ themes }: { themes: string[] }) {
  return (
    <select
      defaultValue={typeof document !== "undefined" ? document.documentElement.dataset.theme : undefined}
      onChange={(e) => {
        const t = e.target.value;
        const root = document.documentElement;
        root.classList.add("no-transitions");
        root.dataset.theme = t;
        localStorage.setItem("theme", t);
        requestAnimationFrame(() => requestAnimationFrame(() => root.classList.remove("no-transitions")));
      }}
    >
      {themes.map((t) => <option key={t} value={t}>{t}</option>)}
    </select>
  );
}
.no-transitions, .no-transitions * { transition: none !important; }

Класс no-transitions убирает рябь, когда у сотни элементов одновременно анимируется цвет фона и границ.

Вариант с cookie

Если тема хранится в cookie, сервер может сразу отрендерить <html data-theme="...">, и скрипт не нужен. Цена — чтение cookies() в корневом layout делает все страницы динамическими, и статическая генерация пропадает. Для контентного сайта со статикой скрипт выгоднее, для приложения за авторизацией, где всё и так динамическое, cookie чище.

Диагностика

  • Мигание осталось: проверьте в исходном HTML (view-source:), что скрипт стоит в <head> перед стилями и не превращён сборщиком в отложенный.
  • Мигает только часть элементов: где-то цвета заданы напрямую (bg-white, #fff), а не через переменные. Поиск по bg-white|text-black|#fff в компонентах.
  • Предупреждение гидратации на body: suppressHydrationWarning стоит не на том элементе, или тема меняет классы на body, а не атрибут на html.

Когда восемь тем не нужны

Большинству продуктов хватает светлой, тёмной и системной. Каждая дополнительная тема — это проверка контраста всех состояний компонентов. Восемь тем оправданы там, где персонализация — часть продукта: редакторы кода, инструменты для разработчиков, читалки.

Обсуждение (0)

Ещё на vbcd4u.com