الوضع الداكن
الوضع الداكن يبدّل متغيرات الثيم لا أصنافك: فعّله، واتبع إعداد النظام دون وميض، ولماذا الداكن في الثيم الافتراضي محايد.
الوضع الداكن في Ritla UI وضعٌ لمتغيرات الثيم، لا مجموعة ثانية من الأصناف. الصنف نفسه، مثل bg-surface-lowest أو text-gray-txt-primary، يأخذ قيمة فاتحة أو داكنة بحسب موضعه، والأنماط القليلة التي تحتاج صنفًا مشروطًا بالوضع الداكن تستخدم theme-dark:، لا dark: من Tailwind، فتلك تبقى لك.
فعّله#
يتحول Ritla UI إلى الداكن بالطريقة نفسها التي يتحول بها تطبيقك. يسألك npx ritla init عن هذه الطريقة، ويستورد ألوان الثيم الداكنة والبادئة الشرطية theme-dark: الخاصة بها وحدها:
| ينتقل تطبيقك إلى الداكن بـ | ضع هذا على <html> أو على أي عنصر أب |
|---|---|
الصنف .dark (الافتراضي، وهو عُرف shadcn) | class="dark" |
السمة data-theme | data-theme="dark" |
| إعداد النظام وحده | لا شيء: إعداد النظام لدى القارئ هو الذي يقرّر. وclass="light" أو data-theme="light" على <html> يُبقي الصفحة فاتحة |
يظهر كل ما بداخل العنصر داكنًا. أما غياب ذلك، أو الصنف light، أو data-theme="light"، فيُظهر الوضع الفاتح.
<html lang="ar" dir="rtl" class="dark">ومع الصنف أو السمة يوضع أيّهما على عنصر أعلى، فيمكن لقسم واحد أن يخالف الصفحة: بطاقة فاتحة داخل صفحة داكنة تأخذ class="light" (أو data-theme="light") على البطاقة نفسها. أما مع إعداد النظام فتتبع الصفحة كلها نظام القارئ.
اتبع إعداد النظام#
إن كان في تطبيقك زر خاص به للتبديل بين الفاتح والداكن، فاستخدم طريقة الصنف أو السمة، واقرأ تفضيل القارئ قبل أول رسم للصفحة، حتى لا تومض فاتحةً ثم تتحول إلى الداكن. يكفي سكربت صغير داخل <head>:
<script> const stored = localStorage.getItem("theme"); const dark = stored ? stored === "dark" : matchMedia("(prefers-color-scheme: dark)").matches; document.documentElement.classList.toggle("dark", dark);</script>ومع طريقة data-theme اضبط document.documentElement.dataset.theme على "dark" أو "light" بدلًا من ذلك. في Next.js ضع السكربت في التخطيط الجذري، وأضف suppressHydrationWarning إلى <html>، لأن الصنف يُضبط قبل أن يبدأ React عمله.
محايد لا مصبوغ#
الوضع الداكن في الثيم الافتراضي رمادي محايد لا أسود مائل إلى الزرقة، فتحتفظ ألوان العلامة وألوان الحالات بالمعنى نفسه الذي تحمله في الوضع الفاتح.
المعاينات#
كل معاينة مكوّن على هذا الموقع تقبل التبديل نفسه، فتستطيع أن ترى المكوّن داكنًا، وبالعربية، وبالأرقام المشرقية، قبل أن تثبّته.