watchEffect 处理主题样式变化的核心逻辑是自动追踪主题响应式数据(如 isDark),立即写入 :root CSS 变量并切换 HTML class;统一前缀、字符串化赋值、联动 localStorage 与系统偏好,SSR 需判空。

watchEffect 处理主题样式变化的核心逻辑是:自动追踪主题状态,触发时立即写入 CSS 变量,并配合 class 切换覆盖特殊样式。它不监听 CSS 变量本身,而是监听控制主题的响应式数据(比如 isDark 或 themeColor),让样式更新完全由数据驱动。
用 ref 定义主题状态并自动追踪
主题开关或配色方案应封装为响应式 ref,watchEffect 会“触碰”它并建立依赖关系。例如:
- 定义
const isDark = ref(localStorage.getItem('theme') === 'dark'),初始化即读取本地偏好 - 在 watchEffect 内部直接使用
isDark.value,无需手动声明监听源 - 后续只要修改
isDark.value = true,watchEffect 就会立刻重跑整个副作用函数
动态写入 :root CSS 变量
所有主题变量应统一挂载到 :root(即 document.documentElement),确保全局可继承:
- 调用
document.documentElement.style.setProperty('--theme-bg', isDark.value ? '#121212' : '#ffffff') - 推荐统一前缀如
--theme-,避免与其他库冲突 - 注意:CSS 变量只接受字符串,布尔值、数字需显式转为合法 CSS 值(如
isDark.value ? 'var(--dark-text)' : 'var(--light-text)')
同步更新 HTML class 控制复杂样式
CSS 变量无法直接控制 SVG fill、filter、box-shadow 等属性,此时需搭配 class 切换:
- 在 watchEffect 中执行
document.documentElement.classList.toggle('dark', isDark.value) - 对应 CSS 写成
.dark .card { box-shadow: 0 2px 8px rgba(0,0,0,0.3); } - 不建议操作
,因为部分样式(如:root变量作用域)以为根更稳定
持久化与系统偏好联动
用户切换后需保存,且支持跟随系统主题:
- 在 watchEffect 内同步调用
localStorage.setItem('theme', isDark.value ? 'dark' : 'light') - 用
window.matchMedia('(prefers-color-scheme: dark)')监听系统变化,更新isDark即可触发全套更新 - 服务端渲染(如 Nuxt)中加
if (typeof document !== 'undefined')判断,避免报错
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










