رفتن به محتوای اصلی
  • معرفی
  • نصب
  • Tailwind
  • وب کامپوننت‌ها (بدون React)
  • دوزبانه، فارسی و انگلیسی
  • پلاگین‌های فیگما
  • استفاده با هوش مصنوعی
  • آیکون‌ها
  • راهنمای آیکون‌ها
  • سفارشی‌سازی و تم
  • حرکت و ریزتعامل‌ها
  • حالت‌های کامپوننت‌ها
  • فونت و تایپوگرافی
  • دسترس‌پذیری
  • نوشتن متن رابط
  • رنگ‌ها
  • برند کاشی
  • مقایسه با دیگران
  • نسخه‌ها
  • سیاست تغییرات
  • مهاجرت به ۲.۰
  • امنیت
  • حجم کامپوننت‌ها
  • فیلد فارسی
  • دیت‌پیکر شمسی
  • کد تأیید (OTP)
  • بازهٔ تاریخ شمسی
  • انتخاب ماه
  • شمارش معکوس
  • هیت‌مپ فعالیت
  • انتخاب استان
  • نقشهٔ ایران
  • فرم نشانی
  • انتخاب نوبت
  • ویرایش نگارشی
  • نمایش مبلغ
  • بازهٔ قیمت
  • کارت بانکی
  • رسید پرداخت
  • برگ تقویم
  • لوگوی بانک‌ها
  • ابزارهای فارسی
  • آپلود فایل
  • آکاردئون
  • آواتار
  • اسپلیتر
  • استپر
  • اسکلتون
  • اسلایدر
  • اعتبارسنجی فرم
  • امتیاز ستاره‌ای
  • انتخاب چندتایی
  • انتخاب رنگ
  • بج
  • بردکرامب
  • برگهٔ پایین
  • بنر
  • پاپ‌اور
  • تایم‌لاین
  • تب‌ها
  • تور معرفی
  • توست
  • تولتیپ
  • جداکننده و کلید میان‌بر
  • جدول داده
  • جستجو با پیشنهاد
  • چک‌باکس
  • چیپس
  • حالت خالی
  • دراپ‌داون
  • دکمه
  • دکمهٔ کپی
  • دیالوگ
  • رادیو
  • سایدبار
  • سگمنت
  • سلکت
  • سوییچ
  • صفحه‌بندی
  • قدرت رمز عبور
  • کارت
  • کارت آمار
  • کاروسل
  • کامبوباکس
  • کامند پالت
  • کشو
  • گروه دکمه
  • گیج
  • منوی راست‌کلیک
  • نمای درختی
  • نمودار
  • نمونهٔ رنگ
  • نوار پیشرفت
  • نوار ناوبری
  • ورودی
  • ورودی تگ
  • ورودی عدد
  • ویرایش درجا
  • هشدار
شروع کنید

حالت تاریک درست؛ با توکن‌ها، نه با برعکس کردن رنگ‌ها

چطور حالت تاریک بسازیم که فقط سیاه‌شدهٔ حالت روشن نباشد: توکن‌های معنایی، prefers-color-scheme، جلوگیری از چشمک، کنتراست، سایه‌ها و تصویرها.

سپنتا پویا۳ دقیقه مطالعه

کاشی‌های سبزآبی با آیکون ماه و خورشید، نماد تم تیره و روشن

حالت تاریک دیگر یک امکان لوکس نیست؛ بسیاری از کاربران سیستم‌عاملشان را تیره گذاشته‌اند و سایتی که با یک صفحهٔ کاملاً سفید باز می‌شود، چشمشان را می‌زند. ولی تم تیرهٔ خوب با filter: invert(1) یا برعکس کردن رنگ‌ها ساخته نمی‌شود. اگر پایه‌اش درست باشد، اضافه کردنش ساده است.

پایه: توکن‌های معنایی

اگر در CSS رنگ‌ها را مستقیم نوشته باشید (background: #fff; color: #111)، برای تم تیره باید تک‌تک‌شان را پیدا و بازنویسی کنید. اگر از توکن‌های معنایی استفاده کرده باشید، تم تیره فقط یک بلوک CSS است:

[data-theme="light"] {
  --k-bg-primary: #ffffff;
  --k-text-primary: #101418;
  --k-border-secondary: #e4e7eb;
}
[data-theme="dark"] {
  --k-bg-primary: #0a0c0f;
  --k-text-primary: #f2f4f5;
  --k-border-secondary: #23282e;
}
.card { background: var(--k-bg-primary); color: var(--k-text-primary); }

کامپوننت‌ها هیچ‌چیز از تم نمی‌دانند؛ فقط نقش‌ها را صدا می‌زنند.

یک کارت سفارش در دو تم روشن و تیره کنار هم، با همان کد و توکن‌های متفاوت
یک کامپوننت، دو مجموعه مقدار برای توکن‌ها؛ هیچ کلاس جدایی برای تم تیره لازم نیست.

تیره یعنی برعکس نیست

تم تیره قاعده‌های خودش را دارد:

  • سیاه مطلق نه. #000 روی صفحه‌های OLED لبه‌های تند می‌سازد و متن سفید رویش «می‌لرزد». خاکستری بسیار تیره (مثل #0a0c0f) چشم‌نوازتر است.
  • سفید مطلق نه. متن اصلی را کمی کم‌نورتر از سفید بگذارید؛ کنتراست کافی می‌ماند و خیرگی کم می‌شود.
  • عمق با روشن‌تر شدن، نه سایه. در تم روشن، کارت بالاتر سایهٔ بیشتری دارد. در تم تیره سایه دیده نمی‌شود؛ لایه‌های بالاتر کمی روشن‌ترند.
  • رنگ برند را دوباره تنظیم کنید. رنگی که روی سفید خوب است، روی زمینهٔ تیره ممکن است کدر یا خیلی تند باشد. معمولاً یک پلهٔ روشن‌تر از همان طیف بهتر است.
  • رنگ‌های وضعیت روشن‌تر. قرمز خطا و سبز موفقیت در تم تیره باید روشن‌تر باشند تا کنتراست ۴٫۵ به ۱ را حفظ کنند.
مقایسهٔ تم تیرهٔ برعکس‌شده با سیاه مطلق و رنگ‌های تند در مقابل تم تیرهٔ تنظیم‌شده با لایه‌های خاکستری
برعکس کردن رنگ‌ها کنتراست و عمق را خراب می‌کند؛ تم تیره به مقدارهای خودش نیاز دارد.

احترام به تنظیم سیستم

پیش‌فرض خوب این است که سایت از تنظیم سیستم‌عامل پیروی کند و کاربر بتواند آن را عوض کند:

const saved = localStorage.getItem("theme"); // "light" | "dark" | null
const system = matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
document.documentElement.dataset.theme = saved ?? system;

و ویژگی color-scheme را هم بگذارید تا نوار اسکرول، فیلدهای فرم پیش‌فرض و پس‌زمینهٔ صفحه هم تیره شوند:

<meta name="color-scheme" content="dark light">

جلوگیری از چشمک

اگر تم بعد از بارگذاری جاوااسکریپت اعمال شود، صفحه یک لحظه سفید و بعد تیره می‌شود. راه حل: اسکریپت کوچک تعیین تم را درون <head> و پیش از CSS اصلی بگذارید، به‌شکل inline و بدون defer. چند خط کد است و پیش از اولین نقاشی صفحه اجرا می‌شود.

تصویرها و نمودارها

نمودار میله‌ای یکسان در تم روشن و تیره که رنگ میله‌ها و پس‌زمینه‌اش از توکن‌ها می‌آید
وقتی رنگ نمودار هم از توکن بیاید، با عوض شدن تم خودش هماهنگ می‌شود.
  • لوگو و تصویرهای با پس‌زمینهٔ سفید در تم تیره مثل یک مستطیل نورانی دیده می‌شوند. از SVG با currentColor یا نسخهٔ تیرهٔ جداگانه استفاده کنید (<picture> با media="(prefers-color-scheme: dark)").
  • رنگ‌های نمودار را هم از توکن بگیرید تا در تم تیره روشن‌تر شوند.
  • عکس‌ها را تیره نکنید. فیلتر روی عکس محصول، رنگ واقعی را خراب می‌کند.

بخشی تیره در صفحهٔ روشن

گاهی یک بخش (مثل هیروی صفحهٔ اصلی یا پانویس) همیشه تیره است. با توکن‌ها این هم ساده است: data-theme="dark" را روی همان بخش بگذارید و همهٔ کامپوننت‌های داخلش خودشان تیره می‌شوند.

<section data-theme="dark">…</section>

جمع‌بندی

تم تیرهٔ خوب نتیجهٔ توکن‌های معنایی است، نه برعکس کردن رنگ‌ها. سیاه و سفید مطلق را کنار بگذارید، رنگ برند و وضعیت‌ها را برای زمینهٔ تیره تنظیم کنید، از تنظیم سیستم پیروی کنید و جلوی چشمک را بگیرید. همهٔ کامپوننت‌های کاشی با data-theme در هر دو تم کار می‌کنند و تم‌ساز مقدارهای تیره را برای رنگ برند شما هم می‌سازد.