css教程网 css教程网365css.cn
公告为您打开互联网世界的窗户关于本站
首页/实战/正文
RECIPES · 实战

深色模式:一套变量,两种配色

不是把颜色反过来那么简单——对比度、阴影、图片、表单控件都要单独处理。

更新于 2026-10-26 阅读约 10 分钟 标签 深色模式 / 主题

深色模式最常见的错误做法是「白底黑字变成黑底白字」。结果纯黑背景上的纯白文字像在发光,卡片之间的层次全没了,阴影变成一团黑。真正要做的只有一件事:把颜色抽成语义变量,再给一套深色取值。

先定义语义变量#

CSS
: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. 阴影换成「暗+散」

浅色下阴影靠透明度堆叠,深色下黑阴影看不见。改用更深的底色 + 边框来区分层次:

CSS
[data-theme="dark"] .card {
  background: var(--surface);
  border: 1px solid var(--line);
  box-shadow: none;              /* 用边框代替阴影 */
}

2. 图片压暗

纯白背景的产品图、带白底的截图,在深色下会像一块块发光的方块:

CSS
[data-theme="dark"] .prose img { filter: brightness(.86) contrast(1.05); }

3. 半透明遮罩

CSS
[data-theme="dark"] .overlay { background: rgb(0 0 0 / .65); }

浅色下用 rgb(0 0 0 / .45) 够用,深色下要加深到 .65 才有隔离感。

切换逻辑:三行就够#

JS
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 那部分),避免刷新时先闪一下白屏。这是深色模式最常见的体验瑕疵。

要不要跟随系统#

CSS
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) {
    --bg: #0b0f17;
    /* …深色变量 */
  }
}

默认跟随系统,用户手动切换后写死。别做成「必须手动点一下才有深色」,那会让一半用户在夜里被闪到。