两行 CSS 轻松实现明暗模式

2024年 2月 20日 63.0k 0

在 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。

相关文章

JavaScript2024新功能:Object.groupBy、正则表达式v标志
PHP trim 函数对多字节字符的使用和限制
新函数 json_validate() 、randomizer 类扩展…20 个PHP 8.3 新特性全面解析
使用HTMX为WordPress增效:如何在不使用复杂框架的情况下增强平台功能
为React 19做准备:WordPress 6.6用户指南
如何删除WordPress中的所有评论

发布评论