HTML / CSS / 系统课时
理解暗色模式策略
理解暗色模式策略
暗色模式真正需要决定的不是颜色类怎么写,而是谁来判定当前主题。本课比较“跟随系统”和“用户手动选择”两种策略,并实现浅色、深色、跟随系统三态逻辑,让主题来源、持久化和页面生效顺序保持一致。
学习目标
- 说明
dark:变体与主题触发条件之间的关系。 - 比较系统偏好、手动切换和三态策略的适用场景。
- 使用根元素类名、
localStorage与媒体查询同步主题。
策略如何工作
Tailwind 的 dark: 变体只描述“暗色条件成立时使用什么样式”,它本身不保存用户选择。默认情况下,暗色条件来自 prefers-color-scheme: dark;改用自定义选择器后,则由根元素上的类名或属性决定。

系统偏好方案几乎不需要 JavaScript,页面会随操作系统变化,适合内容站、文档站和没有账号偏好的简单产品。它的限制是用户无法在站内覆盖系统设置,也难以把选择同步到账号或其他设备。
手动方案把主题控制权交给产品。用户选择会被保存,刷新后仍可恢复;代价是必须处理首次加载、存储失效、系统变化和页面闪烁。多数应用最终会采用三态策略:显式选择优先,没有保存值时才跟随系统。
实现三态选择
本课以 Tailwind CSS v4 的入口样式写法为准。下面是片段示例,需要放入已正确引入 Tailwind 的 app.css,它把 dark: 的触发条件改为根元素上的 dark 类。
@import "tailwindcss";
/* 根元素或其祖先存在 dark 类时,启用 dark: 变体 */
@custom-variant dark (&:where(.dark, .dark *));生效行为:当 <html class="dark"> 存在时,页面中的 dark:bg-slate-900 等工具类生效;移除该类后恢复基础样式。
下面的 JavaScript 负责读取偏好、更新根元素,并在“跟随系统”状态下监听系统主题变化。它是片段示例,页面中的主题按钮需要分别调用 setTheme("light")、setTheme("dark") 或 setTheme("system")。
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");
}
});预期结果
setTheme("dark") -> html 根元素包含 dark 类
setTheme("light") -> html 根元素不包含 dark 类
setTheme("system") -> 是否包含 dark 类由系统偏好决定选择与验证
只需跟随设备时,保留默认媒体查询最简单;需要站内开关时,使用类名或数据属性;既要用户选择又要系统回退时,使用三态策略。验证时至少覆盖首次访问、刷新恢复、系统主题变化和显式浅色覆盖系统深色四种情况。
为避免页面先显示浅色再切成深色,应在首屏样式计算前应用保存的主题。实际项目可把初始化脚本放在文档头部,或在服务端根据用户偏好直接输出根元素状态。