Теми на Tailwind та CSS-змінних без миготіння під час завантаження: 8 тем і SSR
Звідки миготіння
Користувач вибрав темну тему, вона збережена в 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.
Коли вісім тим не потрібні
Більшості продуктів вистачає світлої, темної та системної. Кожна додаткова тема – це перевірка розмаїття всіх станів компонентів. Вісім тем виправдано там, де персоналізація — частина продукту: редактори коду, інструменти для розробників, читалки.