在bootstrap 5中实现深色模式自动跟随系统,核心是利用 :root 变量配合 @media (prefers-color-scheme: dark) 媒体查询。通过覆盖默认的css自定义属性,页面元素会自动根据操作系统的主题设置切换颜色,无需任何javascript干预。

如何配置根变量以支持深色模式
要实现这一功能,需要在 :root 选择器中定义浅色模式的默认变量,并在深色媒体查询块中重新定义这些变量。Bootstrap 5 的组件样式依赖于这些变量,因此只需替换变量值即可生效。

:root {
--bs-body-bg: #ffffff;
--bs-body-color: #212529;
}
@media (prefers-color-scheme: dark) {
:root {
--bs-body-bg: #212529;
--bs-body-color: #f8f9fa;
}
}上述代码定义了 --bs-body-bg 和 --bs-body-color 两个关键变量。当系统处于浅色模式时,背景为白色,文字为深灰;当系统切换到深色模式时,背景变为深灰,文字变为浅灰。Bootstrap 的其他组件如按钮、卡片等也会自动继承这些变化。
立即学习“前端免费学习笔记(深入)”;
如何验证深色模式是否生效
验证方法非常简单:在操作系统中切换主题设置,观察页面颜色是否随之改变。如果未生效,请检查浏览器开发者工具中的“模拟设备”或“媒体查询”选项,确保 prefers-color-scheme 被正确识别。

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Dark Mode Test</title>
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
<style>
:root {
--bs-body-bg: #ffffff;
--bs-body-color: #212529;
}
@media (prefers-color-scheme: dark) {
:root {
--bs-body-bg: #212529;
--bs-body-color: #f8f9fa;
}
}
</style>
</head>
<body>
<div class="container mt-5">
<h1>Hello, world!</h1>
<p class="lead">This is a test for dark mode.</p>
<button class="btn btn-primary">Primary Button</button>
</div>
</body>
</html>运行上述代码后,将操作系统主题切换为深色,页面背景和文字颜色应自动反转。按钮颜色也可能随主题变化,具体取决于 Bootstrap 的版本和配置。
当使用自定义颜色变量时会发生什么
如果在项目中使用了自定义的 CSS 变量(例如 --my-custom-color),它们不会自动跟随系统主题。必须手动在 @media (prefers-color-scheme: dark) 块中重新定义这些变量,否则自定义颜色将保持浅色模式的设定。


















