Thema's met Tailwind- en CSS-variabelen zonder te knipperen bij het laden: 8 thema's en SSR
Waar komt het knipperen vandaan?
De gebruiker heeft een donker thema geselecteerd, dit wordt opgeslagen in localStorage. Bij het opnieuw opstarten retourneert de server HTML zonder informatie over het onderwerp - hij ziet localStorage niet. De browser tekent een lichte pagina, vervolgens wordt JavaScript geladen, React hydrateert, useEffect leest de instelling en schakelt over naar een andere klasse. Er is een merkbare flits tussen de eerste render en het effect.
Om dit te voorkomen, moet het thema vóór de eerste weergave worden toegepast. Er zijn twee manieren: een synchroon script in <head> of een cookie die de server leest bij het renderen.
Variabelen voor acht thema's
Elk onderwerp is een reeks waarden van dezelfde variabelen. Componenten verwijzen alleen naar semantische namen (--bg, --fg), niet naar specifieke kleuren:
/* 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 is belangrijk: het schakelt systeemelementen (schuifbalken, native select, automatisch invullen van velden) naar de juiste modus. Zonder dit blijven lichte schuifbalken op het donkere thema staan.
Verbinding maken met Tailwind v4
In Tailwind v4 is het thema ingesteld in CSS. De @theme inline richtlijn maakt hulpprogramma's die naar uw variabelen verwijzen in plaats van waarden te kopiëren:
/* 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] *));Nu werken bg-bg, text-fg, border-border en transparantiemodifiers zoals bg-accent/10 voor alle thema's tegelijk. De optie dark: is opnieuw gedefinieerd om te werken met alle donkere thema's; noem ze allemaal. Als donkere thema's alleen qua variabelen verschillen, is dark: mogelijk niet nodig.
Voor Tailwind v3 wordt hetzelfde gedaan in de configuratie: variabelen slaan kleurkanalen op, en in theme.extend.colors - bg: "rgb(var(--bg) / <alpha-value>)".
Script vóór weergave
// 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>
);
}Belangrijkste punten:
- Het script is inline en synchroon, zonder
async/defer, en wordt daarom uitgevoerd voordatbodywordt weergegeven. suppressHydrationWarningnaar<html>: de server heeft het element weergegeven zonderdata-theme, maar de client ziet het attribuut. Onderdrukking heeft alleen invloed op de kenmerken van dit element, niet op de onderliggende elementen.- De waarde uit
localStoragewordt vergeleken met de lijst: anders kan daar een string worden geschreven die de selectors verbreekt. try/catch, omdat toegang totlocalStorageeen uitzondering oplevert in sommige privacymodi.
Als de site een strikte CSP heeft, heeft het inline script nonce of een hash nodig. De next-themes bibliotheek doet hetzelfde en kan met meerdere thema's werken via de attribute="data-theme" en de themes lijst.
Schakelaar
"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; }De klasse no-transitions verwijdert rimpelingen wanneer de achtergrond- en randkleuren van honderden elementen tegelijkertijd worden geanimeerd.
Optie met cookies
Als het thema in een cookie wordt opgeslagen, kan de server <html data-theme="..."> direct weergeven en is er geen script nodig. Prijs - het lezen van cookies() in de hoofdindeling maakt alle pagina's dynamisch en statische generatie verdwijnt. Voor een inhoudssite met statische inhoud is het script winstgevender, voor een applicatie met autorisatie, waar alles dynamisch is, is de cookie schoner.
Diagnostiek
- Knipperen blijft: controleer in de bron-HTML (
view-source:) of het script in<head>vóór de stijlen staat en niet is omgezet in uitgesteld door de bouwer. - Slechts enkele elementen knipperen: op sommige plaatsen worden de kleuren rechtstreeks ingesteld (
bg-white,#fff), en niet via variabelen. Zoek opbg-white|text-black|#fffin componenten. - Hydratatiewaarschuwing op
body:suppressHydrationWarningstaat op het verkeerde element, of het thema verandert de klasse naarbodyin plaats van het attribuut naarhtml.
Wanneer acht onderwerpen niet nodig zijn
De meeste producten hebben voldoende licht, donker en systemisch. Elk bijkomend onderwerp is een test van het contrast van alle componenttoestanden. Acht onderwerpen zijn gerechtvaardigd als personalisatie deel uitmaakt van het product: code-editors, ontwikkelaarstools, lezers.