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

Temas con variables Tailwind y CSS sin parpadear al cargar: 8 temas y SSR

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

¿De dónde viene el parpadeo?

El usuario seleccionó un tema oscuro, se guarda en localStorage. Al reiniciar, el servidor devuelve HTML sin información sobre el tema; no ve localStorage. El navegador dibuja una página ligera, luego se carga JavaScript, React se hidrata, useEffect lee la configuración y cambia de clase. Hay un destello notable entre el primer renderizado y el efecto.

Para evitar esto, el tema debe aplicarse antes del primer render. Hay dos formas: un script sincrónico en <head> o una cookie que el servidor lee al renderizar.

Variables para ocho temas

Cada tema es un conjunto de valores de las mismas variables. Los componentes se refieren únicamente a nombres semánticos (--bg, --fg), no a colores específicos:

/* 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 es importante: cambia los elementos del sistema (barras de desplazamiento, select nativo, autocompletar campos) al modo apropiado. Sin él, las barras de desplazamiento claras permanecerán en el tema oscuro.

Conexión a Tailwind v4

En Tailwind v4, el tema está configurado en CSS. La directiva @theme inline crea utilidades que hacen referencia a sus variables en lugar de copiar valores:

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

Ahora bg-bg, text-fg, border-border y modificadores de transparencia como bg-accent/10 funcionan para todos los temas a la vez. La opción dark: ha sido redefinida para funcionar en todos los temas oscuros; enumerarlos todos. Si los temas oscuros solo difieren en variables, es posible que dark: no sea necesario.

Para Tailwind v3, se hace lo mismo en la configuración: las variables almacenan canales de color y en theme.extend.colors - bg: "rgb(var(--bg) / <alpha-value>)".

Script antes de renderizar

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

Puntos clave:

  • El script está en línea y sincrónico, sin async/defer, por lo tanto se ejecuta antes de renderizar body.
  • suppressHydrationWarning a <html>: el servidor renderizó el elemento sin data-theme, pero el cliente ve el atributo. La supresión sólo afecta a los atributos de este elemento, no a sus hijos.
  • El valor de localStorage se compara con la lista: de lo contrario, se puede escribir una cadena allí que romperá los selectores.
  • try/catch, porque acceder a localStorage genera una excepción en algunos modos de privacidad.

Si el sitio tiene un CSP estricto, el script en línea necesita nonce o un hash. La biblioteca next-themes hace lo mismo y puede trabajar con múltiples temas a través de la lista attribute="data-theme" y themes.

Cambiar

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

La clase no-transitions elimina las ondulaciones cuando cientos de elementos tienen sus colores de fondo y borde animados al mismo tiempo.

Opción con cookies

Si el tema se almacena en una cookie, el servidor puede representar <html data-theme="..."> inmediatamente y no se necesita ningún script. Precio: leer cookies() en el diseño raíz hace que todas las páginas sean dinámicas y la generación estática desaparece. Para un sitio de contenido estático, el script es más rentable, para una aplicación con autorización, donde todo es dinámico, la cookie es más limpia.

Diagnóstico

  • El parpadeo permanece: verifique en el HTML fuente (view-source:) que el script esté en <head> antes de los estilos y que el constructor no lo convierta en diferido.
  • Sólo algunos de los elementos parpadean: en algunos lugares los colores se configuran directamente (bg-white, #fff), y no a través de variables. Buscar por bg-white|text-black|#fff en componentes.
  • Advertencia de hidratación en body: suppressHydrationWarning está en el elemento incorrecto o el tema cambia de clase a body en lugar de atributo a html.

Cuando no se necesitan ocho temas

La mayoría de los productos son bastante claros, oscuros y sistémicos. Cada tema adicional es una prueba del contraste de todos los estados componentes. Se justifican ocho temas donde la personalización es parte del producto: editores de código, herramientas de desarrollo, lectores.

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

Ещё на vbcd4u.com