css颜色变量与主题切换实现方法

实现主题切换的关键在于使用CSS自定义属性管理样式,通过JavaScript动态修改data-theme属性来切换浅色与深色模式,并结合localStorage和prefers-color-scheme实现持久化与系统偏好适配。

实现主题切换的关键在于使用CSS自定义属性(即CSS变量)来管理颜色等样式值。通过动态切换变量的定义,可以快速改变整个页面的视觉风格,比如从“浅色模式”切换到“深色模式”。

定义CSS颜色变量

在根元素 :root 中定义颜色变量,便于全局调用。也可以为不同主题分别定义变量集合。

:root {
  --bg-color: #ffffff;
  --text-color: #333333;
  --primary-color: #007bff;
}

/ 深色主题变量 / [data-theme="dark"] { --bg-color: #1a1a1a; --text-color: #f0f0f0; --primary-color: #00d4ff; }

这样,页面元素只需引用这些变量:

body {
  background-color: var(--bg-color);
  color: var(--text-color);
  transition: background-color 0.3s, color 0.3s;
}

.btn-primary { background-color: var(--primary-color); border: none; }

通过JavaScript切换主题

利用JS操作HTML标签的属性,触发CSS变量的变化,从而实现主题切换。

function setTheme(theme) {
  document.documentElement.setAttribute('data-theme', theme);
}

// 示例:点击按钮切换 document.getElementById('toggle-theme').addEventListener('click', () => { const current = document.documentElement.getAttribute('data-theme'); setTheme(current === 'dark' ? 'light' : 'dark'); });

页面加载时可读取用户偏好(如localStorage或系统设置):

// 启动时恢复上次选择
const savedTheme = localStorage.getItem('theme') || 'light';
setTheme(savedTheme);

// 切换时保存 document.getElementById('toggle-theme').addEventListener('click', () => { const current = document.documentElement.getAttribute('data-theme'); const next = current === 'dark' ? 'light' : 'dark'; setTheme(next); localStorage.setItem('theme', next); });

结合系统偏好自动适配

使用 prefers-color-scheme 可以让页面默认跟随系统主题。

@media (prefers-color-scheme: dark) {
  :root:not([data-theme]) {
    --bg-color: #1a1a1a;
    --text-color: #f0f0f0;
  }
}

如果未手动设置主题,则自动应用深色或浅色变量。配合JS可提供“跟随系统”选项:

if (savedTheme === 'auto') {
  const sysPref = window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
  setTheme(sysPref);
}

基本上就这些。核心是变量定义 + 属性控制 + JS交互,结构清晰,维护方便。