color-scheme属性通过声明页面支持的配色方案，使浏览器自动调整滚动条、表单控件等UI元素以适配用户偏好；结合@media (prefers-color-scheme: dark)定义内容样式，并利用CSS变量与JavaScript实现系统偏好响应及手动切换，可构建完整暗黑模式逻辑；需注意图片适配、第三方内容兼容、默认样式的覆盖及浏览器支持等问题。
通过CSS的color-scheme属性，我们可以非常优雅且高效地让网页适应用户的暗黑模式偏好。这不仅仅是改变一下背景和文字颜色那么简单，它更深层地告诉浏览器你的页面支持哪些配色方案，从而让浏览器能够协调地调整它自身的UI元素，比如滚动条、表单控件等，使得整体体验更加和谐统一。
解决方案
要实现这一点，核心做法其实很简单：在你的html或body元素上设置color-scheme属性。
最常见的用法是：
html {
color-scheme: light dark;
}这行代码的魔力在于，它告诉浏览器：“嘿，我的页面同时支持浅色和深色主题！” 当用户操作系统设置为暗黑模式时，浏览器就会自动以深色模式渲染那些它自己控制的UI元素，比如滚动条的颜色、默认的表单边框等。而当用户设置为浅色模式时，则会使用浅色方案。
立即学习“前端免费学习笔记（深入）”；
当然，这只是基础。为了让你的页面内容也跟随用户的偏好变化，我们还需要结合@media (prefers-color-scheme: dark)媒体查询来定义我们自己的深色模式样式：
/* 默认的浅色模式样式 */
body {
background-color: #ffffff;
color: #333333;
}
/* 当用户偏好深色模式时应用的样式 */
@media (prefers-color-scheme: dark) {
body {
background-color: #1a1a1a;
color: #f0f0f0;
}
}这样一来，color-scheme负责浏览器层面的适配，而@media查询则负责我们自定义内容的样式切换。两者结合，就构成了一个相当完善的暗黑模式适配方案。
color-scheme属性究竟解决了哪些痛点，让暗黑模式适配更轻松？
我个人觉得，color-scheme最让人惊喜的地方，就是它解决了那些我们以前觉得很棘手的“边角料”问题。想想看，在没有这个属性之前，如果你想让滚动条在暗黑模式下也变成深色，那可真是个麻烦事。要么得用一些非标准的CSS（比如::-webkit-scrollbar），要么就得完全依赖JavaScript去动态修改，而且兼容性还不好说。
现在，color-scheme: light dark;一行代码，就能让浏览器自动搞定这些原生UI元素的配色。这包括但不限于：
- 滚动条: 默认的滚动条颜色会根据主题自动调整。
-
表单控件:
input、textarea、select等元素的默认边框、背景色、文字颜色，也会在一定程度上根据主题进行适配。 - 链接高亮: 浏览器默认的链接访问状态颜色也会更协调。
- 系统级弹窗: 如果你的页面触发了浏览器自身的某些提示或弹窗，它们也会遵循这个配色方案。
这种“一劳永逸”的特性，极大地降低了我们开发暗黑模式的初期工作量，也让用户体验更加无缝。它不再是单纯地让我们的内容变黑，而是让整个浏览器环境都融入到暗黑模式中，这才是真正的用户友好。
结合prefers-color-scheme，如何构建一个完善的暗黑模式切换逻辑？
构建一个完善的暗黑模式切换逻辑，不仅仅是让它“能用”，更要让它“好用”且“灵活”。我的做法通常是这样的：
设置基石：
color-scheme首先，在html标签上加上color-scheme: light dark;。这就像给浏览器打了个招呼：“我的页面支持深色模式哦，你那些默认的UI元素就按深色来吧！”-
定义核心样式：
@media (prefers-color-scheme: dark)接着，我们用媒体查询来定义我们应用的主体颜色。我会建议使用CSS变量（Custom Properties）来管理颜色，这样后期维护和切换会非常方便。:root { /* 浅色模式变量 */ --bg-color: #ffffff; --text-color: #333333; --link-color: #007bff; } /* 默认样式，即浅色模式 */ body { background-color: var(--bg-color); color: var(--text-color); } a { color: var(--link-color); } /* 深色模式覆盖 */ @media (prefers-color-scheme: dark) { :root { --bg-color: #1a1a1a; --text-color: #f0f0f0; --link-color: #8ab4f8; /* 亮一点的蓝色 */ } }这样，当用户系统切换到暗黑模式时，我们的CSS变量会自动更新，页面也随之变化。
-
提供用户手动切换选项（可选但推荐） 很多用户喜欢自己控制主题，而不是完全依赖系统设置。这时，我们需要一个切换按钮。
-
JavaScript控制： 当用户点击切换按钮时，用JavaScript在
body或html元素上添加或移除一个类名，比如dark-mode。 -
CSS变量覆盖： 在CSS中，为这个
dark-mode类定义一套新的变量值，优先级高于@media查询。 -
持久化： 使用
localStorage保存用户的选择，这样下次访问时页面能记住用户的偏好。
/* 用户手动切换到深色模式时，覆盖系统偏好 */ body.dark-mode { --bg-color: #1a1a1a; --text-color: #f0f0f0; --link-color: #8ab4f8; /* 确保 color-scheme 也切换，虽然通常浏览器会自动处理 */ color-scheme: dark; } body.light-mode { color-scheme: light; }// 假设这是你的JS逻辑 const toggleButton = document.getElementById('theme-toggle'); const currentTheme = localStorage.getItem('theme'); if (currentTheme) { document.body.classList.add(currentTheme); // 同时更新 color-scheme 属性 document.documentElement.style.colorScheme = currentTheme; } else if (window.matchMedia('(prefers-color-scheme: dark)').matches) { document.body.classList.add('dark-mode'); document.documentElement.style.colorScheme = 'dark'; } else { document.body.classList.add('light-mode'); document.documentElement.style.colorScheme = 'light'; } toggleButton.addEventListener('click', () => { if (document.body.classList.contains('dark-mode')) { document.body.classList.remove('dark-mode'); document.body.classList.add('light-mode'); localStorage.setItem('theme', 'light-mode'); document.documentElement.style.colorScheme = 'light'; } else { document.body.classList.remove('light-mode'); document.body.classList.add('dark-mode'); localStorage.setItem('theme', 'dark-mode'); document.documentElement.style.colorScheme = 'dark'; } });这样，一个既能响应系统偏好，又能让用户自由选择的暗黑模式切换逻辑就搭建起来了。
-
JavaScript控制： 当用户点击切换按钮时，用JavaScript在
在实际项目中应用color-scheme时，有哪些常见的“坑”和兼容性考量？
即便color-scheme非常方便，但在实际项目中落地时，还是会遇到一些需要注意的地方，我把它叫做“坑”吧，毕竟踩过才知道疼。
-
图片和SVG的适配问题： 这是最常见的。如果你的图片（特别是Logo、图标）是硬编码的深色或浅色，那么在切换主题时，它们可能看起来格格不入。
-
解决方案：
- 提供两套图片资源，通过CSS变量或媒体查询来切换。
- 对于纯色图标，使用SVG，并通过CSS
fill或stroke属性来控制颜色。 - 如果图片内容是浅色背景，在深色模式下可以尝试使用
filter: invert(1)来反转颜色，但效果不一定完美。我曾经就遇到过一个logo，反转后颜色变得很奇怪，最后还是老老实实做了两套。
-
解决方案：
-
第三方组件库或嵌入内容： 如果你的项目使用了大量的第三方UI组件库，或者嵌入了外部的iframe内容，
color-scheme可能无法直接影响它们。这些内容有自己的样式体系，不会自动响应你页面的主题。-
解决方案：
- 如果组件库支持暗黑模式，参照其文档进行配置。
- 对于iframe，如果同源，可以通过
postMessage传递主题信息，让iframe内部进行切换。如果不同源，那就没办法了，只能接受它可能不协调的事实。
-
解决方案：
-
用户代理样式表的覆盖： 尽管
color-scheme会影响浏览器默认样式，但有时你自己的CSS可能会不小心覆盖掉这些默认的适配，导致某些元素（比如表单控件）在暗黑模式下看起来还是浅色的。-
解决方案： 仔细检查你的CSS，确保你没有给那些本该由浏览器自动适配的元素（如
input[type="text"]）设置了固定的背景色或边框色，除非你明确需要自定义它们。
-
解决方案： 仔细检查你的CSS，确保你没有给那些本该由浏览器自动适配的元素（如
color-scheme的优先级：color-scheme属性通常设置在html或body上，它的作用是告诉浏览器“我支持这些主题”。如果你在某个子元素上又设置了color-scheme: light;，那么那个子元素及其内部的内容会强制使用浅色模式，即便父元素是dark。这在某些特定场景下有用，但如果不是刻意为之，可能会造成局部主题混乱。浏览器兼容性： 现代浏览器对
color-scheme的支持已经很好了（Chrome, Firefox, Safari都支持），但如果你需要支持非常老的浏览器，可能就需要额外的polyfill或者降级处理了。不过，考虑到暗黑模式本身就是比较新的特性，通常无需过度担心旧浏览器兼容性。
总的来说，color-scheme是一个非常强大的工具，它让我们在暗黑模式适配上少走了很多弯路。但任何工具都有它的边界和使用场景，理解这些“坑”能帮助我们更高效、更稳定地在项目中应用它。
