लोड होने पर बिना पलक झपकाए टेलविंड और सीएसएस वेरिएबल वाली थीम: 8 थीम और एसएसआर
पलक कहाँ से झपक रही है?
उपयोगकर्ता ने एक डार्क थीम का चयन किया, इसे localStorage में सहेजा गया है। रीबूट करते समय, सर्वर विषय के बारे में जानकारी के बिना HTML लौटाता है - यह localStorage नहीं देखता है। ब्राउज़र एक हल्का पेज बनाता है, फिर जावास्क्रिप्ट लोड होता है, रिएक्ट हाइड्रेट होता है, useEffect सेटिंग पढ़ता है और क्लास स्विच करता है। पहले रेंडर और प्रभाव के बीच एक ध्यान देने योग्य फ्लैश है।
इससे बचने के लिए, थीम को पहले रेंडर से पहले लागू किया जाना चाहिए। दो तरीके हैं: <head> में एक सिंक्रोनस स्क्रिप्ट या एक कुकी जिसे रेंडर करते समय सर्वर पढ़ता है।
आठ विषयों के लिए चर
प्रत्येक विषय समान चरों के मानों का एक समूह है। घटक केवल अर्थ संबंधी नामों (--bg, --fg) को संदर्भित करते हैं, विशिष्ट रंगों को नहीं:
/* 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 महत्वपूर्ण है: यह सिस्टम तत्वों (स्क्रॉलबार, मूल select, फ़ील्ड ऑटोफ़िल) को उचित मोड में स्विच करता है। इसके बिना, हल्के स्क्रॉलबार डार्क थीम पर बने रहेंगे।
टेलविंड v4 से कनेक्ट हो रहा है
टेलविंड v4 में, थीम CSS में सेट की गई है। @theme inline निर्देश ऐसी उपयोगिताएँ बनाता है जो मानों की प्रतिलिपि बनाने के बजाय आपके चर को संदर्भित करता है:
/* 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] *));अब bg-bg, text-fg, border-border और bg-accent/10 जैसे पारदर्शिता संशोधक एक साथ सभी विषयों के लिए काम करते हैं। dark: विकल्प को सभी डार्क थीम पर काम करने के लिए फिर से परिभाषित किया गया है; उन सभी को सूचीबद्ध करें. यदि डार्क थीम केवल वेरिएबल्स में भिन्न हैं, तो dark: की आवश्यकता नहीं हो सकती है।
टेलविंड v3 के लिए, कॉन्फ़िगरेशन में भी ऐसा ही किया जाता है: वेरिएबल रंग चैनलों को संग्रहीत करते हैं, और theme.extend.colors - bg: "rgb(var(--bg) / <alpha-value>)" में।
प्रतिपादन से पहले स्क्रिप्ट
// 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>
);
}मुख्य बिंदु:
- स्क्रिप्ट इनलाइन और सिंक्रोनस है, बिना
async/deferके, इसलिए इसेbodyरेंडर करने से पहले निष्पादित किया जाता है। suppressHydrationWarningसे<html>: सर्वर ने तत्व कोdata-themeके बिना प्रस्तुत किया, लेकिन क्लाइंट विशेषता देखता है। दमन केवल इस तत्व के गुणों को प्रभावित करता है, उसके बच्चों को नहीं।localStorageसे मान को सूची के विरुद्ध जांचा जाता है: अन्यथा वहां एक स्ट्रिंग लिखी जा सकती है जो चयनकर्ताओं को तोड़ देगी।try/catch, क्योंकिlocalStorageतक पहुंचने से कुछ गोपनीयता मोड में अपवाद उत्पन्न होता है।
यदि साइट में सख्त सीएसपी है, तो इनलाइन स्क्रिप्ट को nonce या हैश की आवश्यकता है। next-themes लाइब्रेरी भी यही करती है और attribute="data-theme" और themes सूची के माध्यम से कई विषयों के साथ काम कर सकती है।
स्विच करें
"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; }no-transitions वर्ग तब तरंगों को हटा देता है जब एक ही समय में सैकड़ों तत्वों की पृष्ठभूमि और सीमा रंग एनिमेटेड होते हैं।
कुकीज़ वाला विकल्प
यदि थीम को कुकी में संग्रहीत किया जाता है, तो सर्वर सीधे <html data-theme="..."> प्रस्तुत कर सकता है और किसी स्क्रिप्ट की आवश्यकता नहीं है। मूल्य - रूट लेआउट में cookies() पढ़ने से सभी पृष्ठ गतिशील हो जाते हैं, और स्थिर पीढ़ी गायब हो जाती है। स्थिर सामग्री वाली सामग्री साइट के लिए, स्क्रिप्ट अधिक लाभदायक है, प्राधिकरण वाले एप्लिकेशन के लिए, जहां सब कुछ गतिशील है, कुकी साफ है।
निदान
- ब्लिंकिंग बनी हुई है: स्रोत HTML (
view-source:) में जांचें कि स्क्रिप्ट शैलियों से पहले<head>में है और बिल्डर द्वारा विलंबित नहीं की गई है। - केवल कुछ तत्व झपकाते हैं: कुछ स्थानों पर रंग सीधे सेट होते हैं (
bg-white,#fff), और वेरिएबल के माध्यम से नहीं। घटकों मेंbg-white|text-black|#fffद्वारा खोजें। bodyपर हाइड्रेशन चेतावनी:suppressHydrationWarningगलत तत्व पर है, या थीम कक्षाओं कोhtmlकी विशेषता के बजायbodyमें बदल देती है।
जब आठ विषयों की आवश्यकता न हो
अधिकांश उत्पादों में पर्याप्त प्रकाश, अंधेरा और प्रणालीगत होता है। प्रत्येक अतिरिक्त विषय सभी घटक अवस्थाओं के विरोधाभास का परीक्षण है। आठ विषय उचित हैं जहां वैयक्तिकरण उत्पाद का हिस्सा है: कोड संपादक, डेवलपर टूल, पाठक।