在 tailwind css 中处理深色模式适配,核心是配置 darkmode 策略并配合 dark: 前缀使用。推荐将 darkmode 设置为 'class',这样只需在根元素(如 )上切换 class="dark" 即可控制全局主题,同时利用 @media (prefers-color-scheme: dark) 实现自动跟随系统设置。

如何配置 darkMode 策略以支持手动切换?
要支持手动切换深色模式,必须在 tailwind.config.js 中将 darkMode 属性设为 'class'。配置完成后,通过 JavaScript 监听点击事件并在 标签上添加或移除 dark 类名,即可触发样式变化。

// tailwind.config.js
module.exports = {
darkMode: 'class', // 关键配置
theme: {
extend: {},
},
plugins: [],
}
<button id="toggle-btn">切换深色模式</button>
<div class="bg-white text-black dark:bg-gray-800 dark:text-white p-4">
内容区域
</div>
<script>
const btn = document.getElementById('toggle-btn');
btn.addEventListener('click', () => {
document.documentElement.classList.toggle('dark');
});
</script>
运行上述代码后,点击按钮会在浅色和深色背景之间切换。预期结果是:初始状态为白底黑字,点击后变为灰底白字,且仅影响带有 dark: 前缀的样式。
如何实现自动跟随系统深色模式?
若希望页面自动跟随操作系统的深色模式设置,可将 darkMode 配置为 'media'。此时无需任何 JavaScript 干预,Tailwind 会通过 CSS 媒体查询 @media (prefers-color-scheme: dark) 自动应用深色样式。
Lightning CSS 是由 Parcel 团队开发的基于 Rust 的 CSS 解析器、转换器、打包工具和压缩工具。此技能适用于需要优化样式表、为目标浏览器降低现代 CSS 语法以及将快速 CSS 处理集成到构建或重构工作流中的代理。

// tailwind.config.js
module.exports = {
darkMode: 'media', // 自动跟随系统
theme: {
extend: {},
},
plugins: [],
}
<div class="bg-white text-black dark:bg-gray-800 dark:text-white p-4"> 自动跟随系统主题 </div>
当用户操作系统切换到深色模式时,该 div 会自动变为深灰色背景和白色文字。预期结果是与系统主题完全同步,无需额外逻辑判断。
基于 class="dark" 切换时的具体样式表现是什么?
当 元素包含 class="dark" 时,所有以 dark: 开头的工具类才会生效。例如 dark:bg-gray-800 会覆盖默认的 bg-white,而 dark:text-white 会覆盖 text-black。这种机制允许开发者精确控制每个元素的明暗状态,而不必担心全局样式冲突。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










