Motywy ze zmiennymi Tailwind i CSS bez mrugania przy ładowaniu: 8 motywów i SSR
Skąd to mruganie?
Użytkownik wybrał ciemny motyw, zostaje on zapisany w localStorage. Przy ponownym uruchomieniu serwer zwraca HTML bez informacji o temacie - nie widzi localStorage. Przeglądarka rysuje jasną stronę, następnie ładuje JavaScript, React nawadnia, useEffect czyta ustawienie i przełącza klasę. Pomiędzy pierwszym renderem a efektem widać zauważalny błysk.
Aby tego uniknąć, motyw należy zastosować przed pierwszym renderowaniem. Istnieją dwa sposoby: skrypt synchroniczny w <head> lub plik cookie odczytywany przez serwer podczas renderowania.
Zmienne dla ośmiu tematów
Każdy temat jest zbiorem wartości tych samych zmiennych. Komponenty odnoszą się jedynie do nazw semantycznych (--bg, --fg), a nie do konkretnych kolorów:
/* 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 jest ważny: przełącza elementy systemu (paski przewijania, natywny select, autouzupełnianie pól) do odpowiedniego trybu. Bez tego jasne paski przewijania pozostaną na ciemnym motywie.
Łączenie z Tailwind v4
W Tailwind v4 motyw jest ustawiony w CSS. Dyrektywa @theme inline tworzy narzędzia, które odwołują się do twoich zmiennych, zamiast kopiować wartości:
[[VB_1_KOD]]
Teraz bg-bg, text-fg, border-border i modyfikatory przezroczystości, takie jak bg-accent/10 działają dla wszystkich motywów jednocześnie. Opcja dark: została przedefiniowana tak, aby działała na wszystkich ciemnych motywach; wymień je wszystkie. Jeśli ciemne motywy różnią się tylko zmiennymi, dark: może nie być potrzebny.
W przypadku Tailwind v3 to samo dzieje się w konfiguracji: zmienne przechowują kanały kolorów, a w theme.extend.colors - bg: "rgb(var(--bg) / <alpha-value>)".
Skrypt przed renderowaniem
// 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>
);
}Kluczowe punkty:
- Skrypt jest wbudowany i synchroniczny, bez
async/defer, dlatego jest wykonywany przed renderowaniembody. suppressHydrationWarningna<html>: serwer wyrenderował element bezdata-theme, ale klient widzi atrybut. Tłumienie wpływa tylko na atrybuty tego elementu, a nie na jego dzieci.- Wartość z
localStoragejest sprawdzana z listą: w przeciwnym razie można tam zapisać ciąg znaków, który przerwie selektory. try/catch, ponieważ dostęp dolocalStoragepowoduje zgłoszenie wyjątku w niektórych trybach prywatności.
Jeśli witryna ma ścisły CSP, wbudowany skrypt potrzebuje nonce lub skrótu. Biblioteka next-themes robi to samo i może pracować z wieloma motywami za pośrednictwem list attribute="data-theme" i themes.
Przełącz
"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>
);
}[[VB_4_KOD]]
Klasa no-transitions usuwa zmarszczki, gdy setki elementów mają jednocześnie animowane kolory tła i obramowania.
Opcja z plikami cookie
Jeśli motyw jest zapisany w pliku cookie, serwer może natychmiast wyrenderować <html data-theme="..."> i nie jest potrzebny żaden skrypt. Cena - wczytanie cookies() w układzie głównym powoduje, że wszystkie strony stają się dynamiczne, a generowanie statyczne znika. W przypadku witryny treści ze statyczną zawartością skrypt jest bardziej opłacalny, dla aplikacji z autoryzacją, gdzie wszystko jest dynamiczne, plik cookie jest czystszy.
Diagnostyka
- Migające pozostaje: sprawdź źródłowy kod HTML (
view-source:), czy skrypt znajduje się w<head>przed stylami i nie został przekształcony w odroczony przez konstruktora. - Migają tylko niektóre elementy: w niektórych miejscach kolory ustawiane są bezpośrednio (
bg-white,#fff), a nie poprzez zmienne. Wyszukaj wedługbg-white|text-black|#fffw komponentach. - Ostrzeżenie o nawodnieniu w
body:suppressHydrationWarningznajduje się na niewłaściwym elemencie lub motyw zmienia klasę nabodyzamiast atrybutu nahtml.
Gdy osiem tematów nie jest potrzebnych
Większość produktów ma wystarczającą ilość światła, ciemności i systemowości. Każdy dodatkowy temat jest sprawdzianem kontrastu wszystkich stanów składowych. Osiem tematów jest uzasadnionych tam, gdzie personalizacja jest częścią produktu: edytory kodu, narzędzia programistyczne, czytniki.