HTML / CSS / 系统课时

理解暗色模式策略

理解暗色模式策略

暗色模式真正需要决定的不是颜色类怎么写,而是谁来判定当前主题。本课比较“跟随系统”和“用户手动选择”两种策略,并实现浅色、深色、跟随系统三态逻辑,让主题来源、持久化和页面生效顺序保持一致。

学习目标

  • 说明 dark: 变体与主题触发条件之间的关系。
  • 比较系统偏好、手动切换和三态策略的适用场景。
  • 使用根元素类名、localStorage 与媒体查询同步主题。

策略如何工作

Tailwind 的 dark: 变体只描述“暗色条件成立时使用什么样式”,它本身不保存用户选择。默认情况下,暗色条件来自 prefers-color-scheme: dark;改用自定义选择器后,则由根元素上的类名或属性决定。

系统偏好与手动主题策略

系统偏好方案几乎不需要 JavaScript,页面会随操作系统变化,适合内容站、文档站和没有账号偏好的简单产品。它的限制是用户无法在站内覆盖系统设置,也难以把选择同步到账号或其他设备。

手动方案把主题控制权交给产品。用户选择会被保存,刷新后仍可恢复;代价是必须处理首次加载、存储失效、系统变化和页面闪烁。多数应用最终会采用三态策略:显式选择优先,没有保存值时才跟随系统。

实现三态选择

本课以 Tailwind CSS v4 的入口样式写法为准。下面是片段示例,需要放入已正确引入 Tailwind 的 app.css,它把 dark: 的触发条件改为根元素上的 dark 类。

css
@import "tailwindcss";

/* 根元素或其祖先存在 dark 类时,启用 dark: 变体 */
@custom-variant dark (&:where(.dark, .dark *));

生效行为:当 <html class="dark"> 存在时,页面中的 dark:bg-slate-900 等工具类生效;移除该类后恢复基础样式。

下面的 JavaScript 负责读取偏好、更新根元素,并在“跟随系统”状态下监听系统主题变化。它是片段示例,页面中的主题按钮需要分别调用 setTheme("light")、setTheme("dark") 或 setTheme("system")。

js
const systemTheme = window.matchMedia("(prefers-color-scheme: dark)");

function applyTheme(theme) {
  const useDark =
    theme === "dark" || (theme === "system" && systemTheme.matches);

  document.documentElement.classList.toggle("dark", useDark);
  document.documentElement.style.colorScheme = useDark ? "dark" : "light";
}

function setTheme(theme) {
  if (theme === "system") {
    localStorage.removeItem("theme");
  } else {
    localStorage.setItem("theme", theme);
  }

  applyTheme(theme);
}

const savedTheme = localStorage.getItem("theme") ?? "system";
applyTheme(savedTheme);

systemTheme.addEventListener("change", () => {
  if (!localStorage.getItem("theme")) {
    applyTheme("system");
  }
});

预期结果

text
setTheme("dark")   -> html 根元素包含 dark 类
setTheme("light")  -> html 根元素不包含 dark 类
setTheme("system") -> 是否包含 dark 类由系统偏好决定

选择与验证

只需跟随设备时,保留默认媒体查询最简单;需要站内开关时,使用类名或数据属性;既要用户选择又要系统回退时,使用三态策略。验证时至少覆盖首次访问、刷新恢复、系统主题变化和显式浅色覆盖系统深色四种情况。

为避免页面先显示浅色再切成深色,应在首屏样式计算前应用保存的主题。实际项目可把初始化脚本放在文档头部,或在服务端根据用户偏好直接输出根元素状态。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解暗色模式策略

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通