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

Temas com variáveis ​​Tailwind e CSS sem piscar ao carregar: 8 temas e SSR

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

De onde vem o piscar?

O usuário selecionou um tema escuro, ele é salvo em localStorage. Ao reiniciar, o servidor retorna HTML sem informações sobre o tópico - ele não vê localStorage. O navegador desenha uma página leve, então o JavaScript carrega, o React hidrata, useEffect lê a configuração e alterna a classe. Há um flash perceptível entre a primeira renderização e o efeito.

Para evitar isso, o tema deve ser aplicado antes da primeira renderização. Existem duas maneiras: um script síncrono em <head> ou um cookie que o servidor lê durante a renderização.

Variáveis para oito temas

Cada tópico é um conjunto de valores das mesmas variáveis. Os componentes referem-se apenas a nomes semânticos (--bg, --fg), não a cores específicas:

/* 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 é importante: ele alterna os elementos do sistema (barras de rolagem, select nativo, preenchimento automático de campo) para o modo apropriado. Sem ele, as barras de rolagem claras permanecerão no tema escuro.

Conectando-se ao Tailwind v4

No Tailwind v4, o tema é definido em CSS. A diretiva @theme inline cria utilitários que fazem referência às suas variáveis em vez 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] *));

Agora bg-bg, text-fg, border-border e modificadores de transparência como bg-accent/10 funcionam para todos os temas de uma vez. A opção dark: foi redefinida para funcionar em todos os temas escuros; liste todos eles. Se os temas escuros diferirem apenas nas variáveis, dark: pode não ser necessário.

Para Tailwind v3, o mesmo é feito na configuração: as variáveis ​​​​armazenam canais de cores e em theme.extend.colors - bg: "rgb(var(--bg) / <alpha-value>)".

Script antes da renderização

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

Pontos principais:

  • O script é inline e síncrono, sem async/defer, portanto é executado antes da renderização de body.
  • suppressHydrationWarning para <html>: o servidor renderizou o elemento sem data-theme, mas o cliente vê o atributo. A supressão afeta apenas os atributos deste elemento, não seus filhos.
  • O valor de localStorage é verificado na lista: caso contrário, uma string pode ser escrita lá que quebrará os seletores.
  • try/catch, porque acessar localStorage gera uma exceção em alguns modos de privacidade.

Se o site tiver um CSP estrito, o script embutido precisará de nonce ou de um hash. A biblioteca next-themes faz o mesmo e pode trabalhar com vários temas através da lista attribute="data-theme" e themes.

Trocar

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

A classe no-transitions remove ondulações quando centenas de elementos têm suas cores de fundo e borda animadas ao mesmo tempo.

Opção com cookies

Se o tema estiver armazenado em um cookie, o servidor poderá renderizar <html data-theme="..."> imediatamente e nenhum script será necessário. Preço - a leitura de cookies() no layout raiz torna todas as páginas dinâmicas e a geração estática desaparece. Para um site de conteúdo com conteúdo estático, o script é mais rentável, para uma aplicação com autorização, onde tudo é dinâmico, o cookie é mais limpo.

Diagnóstico

  • Piscando permanece: verifique no HTML fonte (view-source:) se o script está em <head> antes dos estilos e não foi transformado em adiado pelo construtor.
  • Apenas alguns elementos piscam: em alguns locais as cores são definidas diretamente (bg-white, #fff), e não através de variáveis. Pesquise por bg-white|text-black|#fff nos componentes.
  • Aviso de hidratação em body: suppressHydrationWarning está no elemento errado, ou o tema muda de classe para body em vez de atributo para html.

Quando oito tópicos não são necessários

A maioria dos produtos possui luz, escuridão e sistêmico suficientes. Cada tópico adicional é um teste de contraste de todos os estados componentes. Oito tópicos se justificam onde a personalização faz parte do produto: editores de código, ferramentas de desenvolvedor, leitores.

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

Ещё на vbcd4u.com