You need to enable JavaScript to run this app. Tailwind CSS 如何实现light/dark/跟随系统设置的主题切换
优惠活动
大模型
产品
解决方案
定价
更多

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的主题切换实现逻辑完全一致,没有任何特殊黑科技:
Stack Overflow 主题设置界面
而且对现有项目的改动极小:你之前写的所有dark:开头的Tailwind类完全不用调整,因为最终触发暗色样式的逻辑还是靠<html>标签上的dark类,和Tailwind的设计完全兼容。

内容的提问来源于stack exchange,提问作者leonnicklas

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 09:06:05