السمات ذات متغيرات Tailwind وCSS دون وميض عند التحميل: 8 سمات وSSR
من أين يأتي الوميض؟
قام المستخدم باختيار سمة داكنة، ويتم حفظها في localStorage. عند إعادة التشغيل، يقوم الخادم بإرجاع HTML بدون معلومات حول الموضوع - ولا يرى localStorage. يرسم المتصفح صفحة خفيفة، ثم يُحمِّل JavaScript، ويرطب React، ويقرأ 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 الأصلية، والملء التلقائي للحقل) إلى الوضع المناسب. بدونها، ستبقى أشرطة التمرير الفاتحة على المظهر الداكن.
الاتصال بـ Tailwind v4
في Tailwind 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:.
بالنسبة إلى Tailwind 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يؤدي إلى استثناء في بعض أوضاع الخصوصية.
إذا كان الموقع يحتوي على CSP صارم، فإن البرنامج النصي المضمن يحتاج إلى 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موجود في العنصر الخاطئ، أو يقوم السمة بتغيير الفئات إلىbodyبدلاً من السمة إلىhtml.
عندما لا تكون هناك حاجة لثمانية مواضيع
تحتوي معظم المنتجات على ما يكفي من الضوء والظلام والنظام. كل موضوع إضافي هو اختبار للتباين بين جميع الحالات المكونة. هناك ثمانية مواضيع لها ما يبررها حيث يكون التخصيص جزءًا من المنتج: محررو الأكواد وأدوات المطورين والقراء.