آموزش CSS

پیاده‌سازی Dark Mode حرفه‌ای با CSS — متغیرها و prefers-color-scheme

۲ دقیقه مطالعه ۱۴۰۵/۰۷/۱۳
۴.۷ (۱۰)
پیاده‌سازی Dark Mode حرفه‌ای با CSS — متغیرها و prefers-color-scheme

دارک مود دیگر یک شوخی visual نیست؛ بخشی از انتظار کاربران است. اما پیاده‌سازی بد آن — با کلاس‌های تکراری و رنگ‌های شسته‌شده — بیشتر از نبودِ آن ضرر دارد. در این آموزش، الگوی استاندارد صنعتی را می‌سازیم: سه لایه متغیر، تشخیص خودکار تم سیستم و سوییچ دستی قابل‌ذخیره.

۱) لایه اول: متغیرهای معنایی

رنگ‌ها را با «معنا» نام‌گذاری کنید، نه ظاهر: --bg، --surface، --text و --muted. بعد مقادیر هر تم را در دو بلاک تعریف می‌کنیم:

:root {
  --bg: #f8fafc; --surface: #ffffff;
  --text: #1e293b; --muted: #64748b;
}
html.dark {
  --bg: #0f172a; --surface: #1e293b;
  --text: #e2e8f0; --muted: #94a3b8;
}
body { background: var(--bg); color: var(--text); }

۲) تشخیص خودکار تم سیستم

با media query prefers-color-scheme: dark می‌توانید تم سیستم کاربر را بخوانید. برای هماهنگی با کلاس html.dark، یک اسکریپت کوتاه inline در <head> (قبل از رندر!) خوانده می‌شود تا فلشِ سفید در دارک‌مود نداشته باشید. نکته‌ای که اکثر آموزش‌ها فراموش می‌کنند: این اسکریپت باید قبل از اولین paint اجرا شود وگرنه کاربر یک پرش رنگ زشت را تجربه می‌کند.

۳) سوییچ دستی و ذخیره انتخاب

  • اولویت اول: انتخاب صریح کاربر در localStorage (کلید مثلاً rwp-theme)
  • اولویت دوم: تم سیستم‌عامل با prefers-color-scheme
  • انتخاب کاربر همیشه بر سیستم‌عامل غلبه می‌کند — این رفتار انتظار کاربر است

دکمه سوییچ را در هدر بگذارید و برای آیکن آن از چرخش نرم (transition) استفاده کنید؛ جزئیات کوچکی است که حس کیفیت می‌دهد.

۴) تله‌های رایج رنگ در دارک مود

خاکستری‌های خالص روی پس‌زمینه تیره، حس «مردگی» می‌دهند؛ به‌جای #000 از طیف‌های آبی‌فام مثل #0f172a استفاده کنید و متن اصلی را خالص سفید نکنید — #e2e8f0 چشم را خیلی کمتر خسته می‌کند. سایه‌ها در دارک مود کم‌اثرند؛ لایه‌بندی را با روشن‌تر بودن سطح بالاتر نشان دهید. و در نهایت کنتراست متن‌ها را با ابزار WCAG بسنجید: حداقل AA یعنی نسبت ۴.۵ به ۱ برای متن عادی.

امتیاز شما به این محتوا

میانگین امتیاز کاربران: ۴.۷ از ۱۰ رأی — برای امتیازدهی وارد شوید

دیدگاه‌ها (۰)

هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!

دیدگاه خود را بنویسید

کپچا

دیدگاه شما پس از تأیید مدیر نمایش داده می‌شود.

شاید بپسندی — مقالات مرتبط