深色模式:一套变量,两种配色
不是把颜色反过来那么简单——对比度、阴影、图片、表单控件都要单独处理。
深色模式最常见的错误做法是「白底黑字变成黑底白字」。结果纯黑背景上的纯白文字像在发光,卡片之间的层次全没了,阴影变成一团黑。真正要做的只有一件事:把颜色抽成语义变量,再给一套深色取值。
先定义语义变量#
:root {
color-scheme: light;
--bg: #ffffff;
--surface: #ffffff;
--surface-2: #f6f8fc;
--fg: #0d1117;
--fg-muted: #6b7482;
--line: #e5e9f0;
--brand: #2b57ff;
--shadow: 0 16px 36px -24px rgb(13 17 23 / .35);
}
[data-theme="dark"] {
color-scheme: dark;
--bg: #0b0f17;
--surface: #111725;
--surface-2: #161e2e;
--fg: #eef2f8;
--fg-muted: #8b97ab;
--line: #222b3b;
--brand: #7ea1ff;
--shadow: 0 16px 36px -24px rgb(0 0 0 / .9);
}注意 --brand 在深色下要提亮。原来的 #2b57ff 放在深底上对比度只有 2:1 左右,文字根本看不清。
三处必须单独调整#
1. 阴影换成「暗+散」
浅色下阴影靠透明度堆叠,深色下黑阴影看不见。改用更深的底色 + 边框来区分层次:
[data-theme="dark"] .card {
background: var(--surface);
border: 1px solid var(--line);
box-shadow: none; /* 用边框代替阴影 */
}2. 图片压暗
纯白背景的产品图、带白底的截图,在深色下会像一块块发光的方块:
[data-theme="dark"] .prose img { filter: brightness(.86) contrast(1.05); }3. 半透明遮罩
[data-theme="dark"] .overlay { background: rgb(0 0 0 / .65); }浅色下用 rgb(0 0 0 / .45) 够用,深色下要加深到 .65 才有隔离感。
切换逻辑:三行就够#
const root = document.documentElement;
const saved = localStorage.getItem('theme');
if (saved) root.dataset.theme = saved;
btn.onclick = () => {
const next = root.dataset.theme === 'dark' ? 'light' : 'dark';
root.dataset.theme = next;
localStorage.setItem('theme', next);
};把这三行内联在 <head> 里(读 localStorage 那部分),避免刷新时先闪一下白屏。这是深色模式最常见的体验瑕疵。
要不要跟随系统#
@media (prefers-color-scheme: dark) {
:root:not([data-theme="light"]) {
--bg: #0b0f17;
/* …深色变量 */
}
}默认跟随系统,用户手动切换后写死。别做成「必须手动点一下才有深色」,那会让一半用户在夜里被闪到。