Tailwind CSS 如何实现light/dark/跟随系统设置的主题切换
Tailwind 三态主题切换(亮/暗/跟随系统)实现方案
说白了根本不需要同时开启两种Tailwind内置的darkMode配置,固定用class模式就能完整实现需求,这也是现有方案里对项目侵入性最低、最简洁的版本。
第一步:基础配置
直接把Tailwind的暗色触发规则锁定为类名模式,不要用默认的media媒体查询配置:
// tailwind.config.js module.exports = { darkMode: 'class', // 保留你原有的所有项目配置即可 }
第二步:无闪烁的主题初始化逻辑
所有关于「判断是用户手动选的亮/暗、还是跟随系统设置」的逻辑,全部由原生JS接管,完全不需要依赖Tailwind自带的媒体查询判断。
核心规则很简单:
- 用户手动选亮色:给
<html>标签移除所有dark类,不管系统当前是什么设置 - 用户手动选暗色:给
<html>标签加上dark类,不管系统当前是什么设置 - 用户选跟随系统:移除手动加的类名,通过JS监听系统的暗色模式偏好变化,动态给
<html>加/移除dark类
关键避坑:初始化脚本一定要放在布局文件
<head>的最顶部、所有页面内容渲染之前执行,不然会出现页面先加载亮色、再跳转到暗色的闪烁问题。Jetstream默认的布局模板本来就预留了这个脚本的位置,直接放进去就行:
// 放在resources/views/layouts/app.blade.php的<head>标签最开头 (function () { const root = document.documentElement // 从本地存储读取用户的主题选择,默认值为跟随系统 const savedTheme = localStorage.getItem('site-theme') || 'system' // 监听系统暗色偏好变化的处理函数 const syncSystemTheme = () => { const isSystemDark = window.matchMedia('(prefers-color-scheme: dark)').matches root.classList.toggle('dark', isSystemDark) } // 页面加载时初始化主题 if (savedTheme === 'dark') { root.classList.add('dark') } else if (savedTheme === 'light') { root.classList.remove('dark') } else { syncSystemTheme() // 系统主题切换时自动同步 window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', syncSystemTheme) } })()
第三步:切换交互落地
结合你现有的Laravel + Livewire技术栈,直接搭一个三选项的主题选择组件就行,不需要引入任何第三方依赖:
- 三个选项分别对应
light/dark/system三个值 - 用户点击选项时,把选择的主题值写入本地存储,然后重新执行上面的初始化逻辑就能即时切换,不需要刷新页面
- 如果需要多设备同步主题偏好,可以把用户的选择存到Fortify关联的用户数据库表里,用户登录时自动从数据库读取偏好值替换本地存储的默认值即可
这个方案和Stack Overflow的主题切换实现逻辑完全一致,没有任何特殊黑科技:
而且对现有项目的改动极小:你之前写的所有dark:开头的Tailwind类完全不用调整,因为最终触发暗色样式的逻辑还是靠<html>标签上的dark类,和Tailwind的设计完全兼容。
内容的提问来源于stack exchange,提问作者leonnicklas
相关产品推荐
相关产品推荐

