QQ登录

只需要一步,快速开始

APP扫码登录

只需要一步,快速开始

查看: 5445|回复: 0

[HTML/CSS/JS] H5 项目如何适配暗黑模式

[复制链接]

等级头衔

积分成就    金币 : 2861
   泡泡 : 1516
   精华 : 6
   在线时间 : 1328 小时
   最后登录 : 2026-5-15

丰功伟绩

优秀达人突出贡献荣誉管理论坛元老活跃会员

联系方式
发表于 2021-5-17 10:23:47 | 显示全部楼层 |阅读模式
一、背景3 G: q: O* B) n) b
       随着 iOS 13 的发布,深色模式(Dark Mode)越来越多地出现在大众的视野中,支持深色模式已经成为现代移动应用和网站的一个潮流,前段时间更是因为微信的适配再度引起热议。深色模式不仅可以大幅减少电量的消耗,减弱强光对比,还能 提供更好的可视性和沉浸感。
- f+ J4 c' R! p( I  j  @2 w: N如何切换深色模式
1 [# {; \5 Z- s5 M" O3 R$ i7 Z8 W
  • iOS:“设置”--“显示与亮度”--“外观”,选择“深色”
  • Android:“系统设置”--“显示”--“深色模式”。1 F/ N( G8 o# I/ i' Z. b8 d
二、问题
# B3 O% [) v. Y- Q: c) }/ M: h" S       如果系统设置了深色模式,H5页面不做相应的处理,会出现背景色冲突、深色文字显示异常,深色图标显示异常等一些显示上的问题。
0 g4 U0 u; b1 U$ ]" V+ y/ S1 s. i       所以,需要对深色模式进行一些适配。
' t4 @' ~0 b, V! L: a+ C( q三、H5项目适配深色模式方案6 ?$ v. H8 Y8 N7 N  W
1.声明 color-scheme0 i& _1 ]% v( S3 f' ?
       color-scheme有两种方式。
: ~" Y- z. p9 v1.1meta
6 D+ J* F: Z% N3 b0 ?( L5 N6 d9 `+ Y" v/ K        在head中声明<meta name="color-scheme" content="light dark">,声明当前页面支持 light 和 dark 两种模式,系统切换到深色模式时,浏览器默认样式也会切换到深色;) G( v# l3 O8 V2 B0 d
1.2CSS% m' ^* n1 m$ U) p
        下面的 css 同样可以实现上面 meta 声明的效果/ N) o6 @4 z3 J6 z' j
:root {
    color-scheme: light dark;
}
      注意:此声明并非为页面做自动适配,只影响浏览器默认样式,更多信息可查阅 W3C 文档 《CSS Color Adjustment Module Level 1》
3 U' Y. q3 h* B6 w# n9 T' c& m2.通过 CSS 媒体查询7 N9 ^- o0 c) Q+ k
       prefers-color-scheme CSS 媒体特性用于检测用户是否有将系统的主题色设置为亮色或者暗色。
  q9 v5 |# T% p
  • no-preference 表示系统未得知用户在这方面的选项。在布尔值上下文中,其执行结果为 false。
  • light 表示用户已告知系统他们选择使用浅色主题的界面。
  • dark 表示用户已告知系统他们选择使用暗色主题的界面。
    3 k3 A3 p! x# @- f6 g8 {) i" R# ]! ^
:root {
    color-scheme: light dark;
    background: white;
    color: black;
}

@media (prefers-color-scheme: dark) {
    :root {
        background: black;
        color: white;
    }
}
//颜色较多的情况,建议使用CSS变量对颜色值进行管理
3.图片适配$ A, m  ]) o1 I" D* e% X
       利用picture+source标签,设置不同模式下的图片 url。
  R, y2 t- c* T, Z) z7 o5 N' `. Y  q) Z       HTML <picture>元素通过包含零或多个 <source> 元素和一个 <img> 元素来为不同的显示/设备场景提供图像版本。浏览器会选择最匹配的子 <source> 元素,如果没有匹配的,就选择 <img> 元素的 src 属性中的URL。然后,所选图像呈现在<img>元素占据的空间中。+ i+ Z$ y+ Y' s, N1 m9 k) x
<picture>
    <!-- 深色模式下的图片 -->
    <source srcset="dark.jpg" media="(prefers-color-scheme: dark)" />
    <!-- 默认模式下的图片 -->
    <img src="light.jpg"/>
</picture>
4. JavaScript中判断当前模式&监听模式变化
5 l9 _4 K, ]) n6 Y# G% X4.1matchMedia8 M4 T6 J+ Y) r. @) f
       Window 的matchMedia() 方法返回一个新的MediaQueryList 对象,表示指定的媒体查询 (en-US)字符串解析后的结果。返回的MediaQueryList 可被用于判定Document是否匹配媒体查询,或者监控一个document 来判定它匹配了或者停止匹配了此媒体查询。
9 o: D. O% {5 G% O, d4.2addListener()
- w6 ]  g0 z7 O6 {) ~) I       MediaQueryList接口的addListener()方法向MediaQueryListener添加一个侦听器,该侦听器将运行自定义回调函数以响应媒体查询状态的更改。
, Z; h8 E! E6 F' q- bJavaScript监听判断
. K$ e% N# k  Z: X8 z$ A$ T
const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)')

function darkModeHandler() {
    if (mediaQuery.matches) {
        console.log('现在是深色模式')
    } else {
        console.log('现在是浅色模式')
    }
}

// 判断当前模式
darkModeHandler()
// 监听模式变化
mediaQuery.addListener(darkModeHandler)
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

QQ|手机版|小黑屋|paopaomj.COM ( 渝ICP备18007172号|渝公网安备50010502503914号 )

GMT+8, 2026-7-12 20:59

Powered by paopaomj X3.5 © 2016-2025 sitemap

快速回复 返回顶部 返回列表