Tema dengan variabel Tailwind dan CSS tanpa berkedip saat memuat: 8 tema dan SSR
Blinknya dari mana?
Pengguna memilih tema gelap, itu disimpan di localStorage. Saat reboot, server mengembalikan HTML tanpa informasi tentang topik - tidak melihat localStorage. Browser menggambar halaman ringan, lalu JavaScript memuat, Bereaksi hidrat, useEffect membaca pengaturan dan mengganti kelas. Ada perbedaan mencolok antara render pertama dan efeknya.
Untuk menghindari hal ini, tema harus diterapkan sebelum render pertama. Ada dua cara: skrip sinkron di <head> atau cookie yang dibaca server saat rendering.
Variabel untuk delapan tema
Setiap topik adalah sekumpulan nilai dari variabel yang sama. Komponen hanya mengacu pada nama semantik (--bg, --fg), bukan pada warna tertentu:
/* 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 penting: ini mengalihkan elemen sistem (scrollbar, select asli, pengisian otomatis bidang) ke mode yang sesuai. Tanpanya, scrollbar terang akan tetap berada pada tema gelap.
Menghubungkan ke Tailwind v4
Di Tailwind v4, tema diatur dalam CSS. Direktif @theme inline membuat utilitas yang mereferensikan variabel Anda, bukan menyalin nilai:
/* 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] *));Sekarang bg-bg, text-fg, border-border dan pengubah transparansi seperti bg-accent/10 berfungsi untuk semua tema sekaligus. Opsi dark: telah didefinisikan ulang agar berfungsi pada semua tema gelap; daftar semuanya. Jika tema gelap hanya berbeda dalam variabel, dark: mungkin tidak diperlukan.
Untuk Tailwind v3, hal yang sama dilakukan di konfigurasi: variabel menyimpan saluran warna, dan di theme.extend.colors - bg: "rgb(var(--bg) / <alpha-value>)".
Skrip sebelum rendering
// 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>
);
}Poin-poin penting:
- Script inline dan synchronous, tanpa
async/defer, oleh karena itu dieksekusi sebelum renderingbody. suppressHydrationWarninghingga<html>: server merender elemen tanpadata-theme, tetapi klien melihat atributnya. Penindasan hanya memengaruhi atribut elemen ini, bukan turunannya.- Nilai dari
localStoragediperiksa berdasarkan daftar: jika tidak, string dapat ditulis di sana yang akan merusak pemilih. try/catch, karena mengakseslocalStoragememunculkan pengecualian dalam beberapa mode privasi.
Jika situs memiliki CSP yang ketat, skrip inline memerlukan nonce atau hash. Pustaka next-themes melakukan hal yang sama dan dapat bekerja dengan banyak tema melalui daftar attribute="data-theme" dan themes.
Beralih
"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; }Kelas no-transitions menghilangkan riak ketika ratusan elemen dianimasikan warna latar belakang dan batasnya secara bersamaan.
Opsi dengan cookie
Jika tema disimpan dalam cookie, server dapat langsung merender <html data-theme="..."> dan tidak diperlukan skrip. Harga - membaca cookies() di tata letak root membuat semua halaman menjadi dinamis, dan pembuatan statis menghilang. Untuk situs konten dengan konten statis, skrip lebih menguntungkan, untuk aplikasi dengan otorisasi, di mana semuanya dinamis, cookie lebih bersih.
Diagnostik
- Berkedip tetap: periksa di HTML sumber (
view-source:) apakah skrip ada di<head>sebelum gaya dan tidak diubah menjadi ditangguhkan oleh pembuat. - Hanya beberapa elemen yang berkedip: di beberapa tempat warna diatur secara langsung (
bg-white,#fff), dan tidak melalui variabel. Cari berdasarkanbg-white|text-black|#fffdi komponen. - Peringatan hidrasi pada
body:suppressHydrationWarningberada pada elemen yang salah, atau tema mengubah kelas menjadibodyalih-alih atribut kehtml.
Ketika delapan topik tidak diperlukan
Sebagian besar produk memiliki cukup cahaya, gelap, dan sistemik. Setiap topik tambahan merupakan ujian terhadap kontras semua status komponen. Delapan topik dibenarkan jika personalisasi merupakan bagian dari produk: editor kode, alat pengembang, pembaca.