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

السمات ذات متغيرات Tailwind وCSS دون وميض عند التحميل: 8 سمات وSSR

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

من أين يأتي الوميض؟

قام المستخدم باختيار سمة داكنة، ويتم حفظها في 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.

عندما لا تكون هناك حاجة لثمانية مواضيع

تحتوي معظم المنتجات على ما يكفي من الضوء والظلام والنظام. كل موضوع إضافي هو اختبار للتباين بين جميع الحالات المكونة. هناك ثمانية مواضيع لها ما يبررها حيث يكون التخصيص جزءًا من المنتج: محررو الأكواد وأدوات المطورين والقراء.

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

Ещё на vbcd4u.com