在 Web 开发中,为了根据用户的偏好模式(明暗模式)调整网页颜色,我们以前可能会使用媒体查询(prefers-color-scheme)。如今,CSS提供了一种更为简便的方法:light-dark()函数。此函数能够根据当前颜色方案自动选择两种颜色中的一种进行输出,从而实现颜色的自适应显示。
以前的明暗模式实现
要根据所使用的浅色模式或深色模式更改颜色值,可以使用 prefers-color-scheme 媒体查询来更改自定义属性的值:
:root {
--text-color: #333; /* 浅色模式的值 */
}
@media (prefers-color-scheme: dark) {
--text-color: #ccc; /* 深色模式的值 */
}
在实现深色模式时,通常会出现一堆重复的CSS变量,用于设置每种模式的值。然后,CSS 将使用这些自定义属性进行实际声明。
body {
color: var(--text-color);
}
未来的明暗模式实现
CSS Color Module Level 5 Specification[1] 新增了一个 light-dark() 函数。该函数接受两个颜色值作为其参数。根据正在使用的颜色方案,它将输出第一个或第二个颜色参数。
light-dark(, );
根据规范,如果使用的颜色方案是light或未知,则该函数计算为第一种颜色的计算值;如果使用的颜色方案是dark,则计算为第二种颜色的计算值。
使用的颜色方案不仅是用户选择的亮暗模式,还需要根据color-scheme属性的值确定使用的颜色方案。color-scheme属性可以指示元素使用哪种颜色方案进行渲染,这个方案会与用户的偏好进行协商,最终确定使用的颜色方案。因此,在使用light-dark()函数时,还需要在CSS中包含对应的color-scheme声明,以确保函数能够正确工作。
:root {
color-scheme: light dark;
}
:root {
--text-color: light-dark(#333, #ccc);
}
对于上面的代码,在浅色模式下返回第一个值,在深色模式下返回第二个值。
可以在特定元素上设置color-scheme,以覆盖默认值,从而强制元素进入所需的模式。
.dark {
color-scheme: dark;
}
对于上面的代码,该元素及其子元素上的 light-dark() 将始终返回 dark对应的值。
下面来看一个简单的例子。以下Demo将展示几个带有.auto类的元素。这些元素能够智能地适应系统颜色模式,自动切换为浅色或深色主题。而带有.light或.dark类的元素则会强制应用对应的颜色模式。
#demo {
color-scheme: light dark;
.dark {
color-scheme: dark;
}
.light {
color-scheme: light;
}
& div {
background: light-dark(#d4d4d4, #000);
color: light-dark(#333, #ccc);
}
}
非颜色值呢?
light-dark() 函数的设计初衷是为了提供一个简单的中间解决方案,仅支持亮色和暗色的切换,并仅适用于颜色值。这一设计选择是有意为之,因为它旨在为最终的解决方案提供一个渐进的过渡。
根据 CSS 工作组的提议,未来的目标是引入一个更强大的函数,暂命名为 schemed-value()。这个函数将具有以下特性:
- 能够响应任何颜色方案值,不仅限于亮色和暗色。
- 支持除颜色之外的多种类型的值,以提供更广泛的定制选项。
它可能看起来像这样:
:root {
color-scheme: dark light custom;
}
body {
color: schemed-value(light hotpink, dark lime, custom rebeccapurple);
}
当前只有light-dark()函数,但已足够应对当前浏览器功能的实际情况:
- 它仅支持浅色和深色模式,因为当前浏览器还不支持color-scheme中的,因此支持其他模式尚无实际意义。
- 它仅处理值,因为解析器需要提前知道正在解析的值类型。light-dark()被明确地定义为处理值。
将功能范围从广泛的schemed-value()缩小到简洁的light-dark(),使得该函数能够按照当前的定义进行工作,而不需要将其纳入长期的发展轨道。此外,light-dark()的名称和语法非常易于记忆和使用,最重要的是它为开发者提供了一个实用的解决方案,满足了他们当前的需求。
浏览器支持
light-dark() 函数的浏览器支持如下:
- Chromium (Blink): ⚠️ 已表示发布意图。预期将包含在 Chrome 123 中。
- Firefox (Gecko): ✅ Firefox 120 开始支持
- Safari (WebKit): ⚠️ 已在主分支的 WebKit 中实现该功能。预期将包含在 Safari TP 188 中。
可以通过以下代码来判断当前使用的浏览器是否支持 CSS light-dark()函数:
@supports(color: light-dark(#fff, #000)) {
#output::after {
content: "✅ 浏览器支持 light-dark()";
background-color: #00ff002b;
}
}
关注浏览器的支持情况:
- Chromium/Blink: Issue #1490618[2] — 已开始(开放状态)
- Firefox/Gecko: Issue #1856999[3] — 已解决
- Safari/WebKit: Issue #262914[4] — 已解决
相关链接
[1]CSS Color Module Level 5 Specification: https://drafts.csswg.org/css-color-5/。
[2]Issue #1490618: https://bugs.chromium.org/p/chromium/issues/detail?id=1490618。
[3]Issue #1856999: https://bugzilla.mozilla.org/show_bug.cgi?id=1856999。
[4]Issue #262914: https://bugs.webkit.org/show_bug.cgi?id=262914。