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

Thema's met Tailwind- en CSS-variabelen zonder te knipperen bij het laden: 8 thema's en SSR

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

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 voordat body wordt weergegeven.
  • suppressHydrationWarning naar <html>: de server heeft het element weergegeven zonder data-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 localStorage wordt vergeleken met de lijst: anders kan daar een string worden geschreven die de selectors verbreekt.
  • try/catch, omdat toegang tot localStorage een 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 op bg-white|text-black|#fff in componenten.
  • Hydratatiewaarschuwing op body: suppressHydrationWarning staat op het verkeerde element, of het thema verandert de klasse naar body in plaats van het attribuut naar html.

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.

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

Ещё на vbcd4u.com