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

Themes mit Tailwind und CSS-Variablen ohne Blinken beim Laden: 8 Themes und SSR

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

Woher kommt das Blinken?

Der Benutzer hat ein dunkles Theme ausgewählt, es wird in localStorage gespeichert. Beim Neustart gibt der Server HTML ohne Informationen zum Thema zurück – er sieht localStorage nicht. Der Browser zeichnet eine Light-Seite, dann lädt JavaScript, React hydratisiert, useEffect liest die Einstellung und wechselt die Klasse. Zwischen dem ersten Rendern und dem Effekt ist ein deutlicher Blitz erkennbar.

Um dies zu vermeiden, muss das Theme vor dem ersten Rendern angewendet werden. Es gibt zwei Möglichkeiten: ein synchrones Skript in <head> oder ein Cookie, das der Server beim Rendern liest.

Variablen für acht Themen

Jedes Thema ist eine Reihe von Werten derselben Variablen. Komponenten beziehen sich nur auf semantische Namen (--bg, --fg), nicht auf bestimmte Farben:

/* 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 ist wichtig: Es schaltet Systemelemente (Bildlaufleisten, nativer select, automatisches Ausfüllen von Feldern) in den entsprechenden Modus. Ohne sie bleiben helle Bildlaufleisten beim dunklen Thema.

Verbindung mit Tailwind v4 herstellen

In Tailwind v4 wird das Theme in CSS festgelegt. Die @theme inline-Direktive erstellt Dienstprogramme, die auf Ihre Variablen verweisen, anstatt Werte zu kopieren:

/* 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] *));

Jetzt funktionieren bg-bg, text-fg, border-border und Transparenzmodifikatoren wie bg-accent/10 für alle Themen gleichzeitig. Die Option dark: wurde neu definiert, um bei allen dunklen Themen zu funktionieren; Listen Sie sie alle auf. Wenn sich dunkle Themen nur in den Variablen unterscheiden, ist dark: möglicherweise nicht erforderlich.

Für Tailwind v3 erfolgt das Gleiche in der Konfiguration: Variablen speichern Farbkanäle und in theme.extend.colors – bg: "rgb(var(--bg) / <alpha-value>)".

Skript vor dem Rendern

// 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>
  );
}

Kernpunkte:

  • Das Skript ist inline und synchron, ohne async/defer, daher wird es vor dem Rendern von body ausgeführt.
  • suppressHydrationWarning bis <html>: Der Server hat das Element ohne data-theme gerendert, aber der Client sieht das Attribut. Die Unterdrückung wirkt sich nur auf die Attribute dieses Elements aus, nicht auf seine untergeordneten Elemente.
  • Der Wert von localStorage wird mit der Liste verglichen: Andernfalls kann dort ein String geschrieben werden, der die Selektoren zerstört.
  • try/catch, da der Zugriff auf localStorage in einigen Datenschutzmodi eine Ausnahme auslöst.

Wenn die Site über einen strengen CSP verfügt, benötigt das Inline-Skript nonce oder einen Hash. Die next-themes-Bibliothek macht dasselbe und kann über die attribute="data-theme"- und die themes-Liste mit mehreren Themen arbeiten.

Wechseln

"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; }

Die Klasse no-transitions entfernt Wellen, wenn die Hintergrund- und Rahmenfarben Hunderter Elemente gleichzeitig animiert werden.

Option mit Cookies

Wenn das Theme in einem Cookie gespeichert ist, kann der Server <html data-theme="..."> sofort rendern und es ist kein Skript erforderlich. Preis – Durch das Lesen von cookies() im Stammlayout werden alle Seiten dynamisch und die statische Generierung verschwindet. Für eine Content-Site mit statischem Inhalt ist das Skript rentabler, für eine Anwendung mit Autorisierung, bei der alles dynamisch ist, ist das Cookie sauberer.

Diagnose

  • Das Blinken bleibt bestehen: Überprüfen Sie im Quell-HTML (view-source:), dass das Skript in <head> vor den Stilen steht und nicht vom Builder in „verzögert“ umgewandelt wird.
  • Nur einige der Elemente blinken: An einigen Stellen werden die Farben direkt festgelegt (bg-white, #fff) und nicht über Variablen. Suchen Sie nach bg-white|text-black|#fff in Komponenten.
  • Hydratationswarnung für body: suppressHydrationWarning befindet sich auf dem falschen Element, oder das Thema ändert die Klassen in body anstelle des Attributs in html.

Wenn acht Themen nicht benötigt werden

Die meisten Produkte verfügen über genügend Licht, Dunkelheit und Systemwirkung. Jedes zusätzliche Thema ist ein Test des Kontrasts aller Komponentenzustände. Begründet werden acht Themen, bei denen Personalisierung Teil des Produkts ist: Code-Editoren, Entwicklertools, Reader.

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

Ещё на vbcd4u.com