一、背景
9 i4 {" T/ x/ i% v0 f. |0 z 随着 iOS 13 的发布,深色模式(Dark Mode)越来越多地出现在大众的视野中,支持深色模式已经成为现代移动应用和网站的一个潮流,前段时间更是因为微信的适配再度引起热议。深色模式不仅可以大幅减少电量的消耗,减弱强光对比,还能 提供更好的可视性和沉浸感。
7 G# a" Z. @, `: y6 d如何切换深色模式
4 v/ q8 ~4 H* d' I( i) p0 a- o" W- iOS:“设置”--“显示与亮度”--“外观”,选择“深色”
- Android:“系统设置”--“显示”--“深色模式”。* E* l1 K( f. D
二、问题
4 y- S, Q2 i/ @5 G$ l 如果系统设置了深色模式,H5页面不做相应的处理,会出现背景色冲突、深色文字显示异常,深色图标显示异常等一些显示上的问题。
1 B/ ~% c% g P8 `, V 所以,需要对深色模式进行一些适配。
. w9 y% x6 Y* p. g+ v8 P0 d8 p, Z三、H5项目适配深色模式方案
Z9 A" p) \$ x5 m7 K1.声明 color-scheme O8 l" T d6 C% R+ g; H4 O
color-scheme有两种方式。- A" z: ?; Q8 h9 ?$ S
1.1meta1 L4 d, T4 R7 l- x! I
在head中声明<meta name="color-scheme" content="light dark">,声明当前页面支持 light 和 dark 两种模式,系统切换到深色模式时,浏览器默认样式也会切换到深色;7 ?" p- ^& T# g" m) ~" J
1.2CSS; O! |! C/ H: K5 G) K+ [3 ~
下面的 css 同样可以实现上面 meta 声明的效果
3 r1 \- X/ G4 U0 y:root {
color-scheme: light dark;
} 注意:此声明并非为页面做自动适配,只影响浏览器默认样式,更多信息可查阅 W3C 文档 《CSS Color Adjustment Module Level 1》" g& ?/ L( J% \5 X8 |# ^
2.通过 CSS 媒体查询% r3 U* B( g: }) O7 b$ A: j& ]
prefers-color-scheme CSS 媒体特性用于检测用户是否有将系统的主题色设置为亮色或者暗色。
0 W; O/ y0 W! L- no-preference 表示系统未得知用户在这方面的选项。在布尔值上下文中,其执行结果为 false。
- light 表示用户已告知系统他们选择使用浅色主题的界面。
- dark 表示用户已告知系统他们选择使用暗色主题的界面。
5 c) ]+ D. P; k4 }3 M- r- b- O$ G2 I
:root {
color-scheme: light dark;
background: white;
color: black;
}
@media (prefers-color-scheme: dark) {
:root {
background: black;
color: white;
}
}
//颜色较多的情况,建议使用CSS变量对颜色值进行管理 3.图片适配
- |4 G ^/ A/ S: a6 ] 利用picture+source标签,设置不同模式下的图片 url。
2 l9 Q$ A4 ?/ M3 R3 c2 Y1 v HTML <picture>元素通过包含零或多个 <source> 元素和一个 <img> 元素来为不同的显示/设备场景提供图像版本。浏览器会选择最匹配的子 <source> 元素,如果没有匹配的,就选择 <img> 元素的 src 属性中的URL。然后,所选图像呈现在<img>元素占据的空间中。
( e- f n5 j7 }: O+ |) a<picture>
<!-- 深色模式下的图片 -->
<source srcset="dark.jpg" media="(prefers-color-scheme: dark)" />
<!-- 默认模式下的图片 -->
<img src="light.jpg"/>
</picture> 4. JavaScript中判断当前模式&监听模式变化
4 D6 c2 W$ S; e4.1matchMedia1 t2 W7 P" a9 [# Y" s1 C: W0 j
Window 的matchMedia() 方法返回一个新的MediaQueryList 对象,表示指定的媒体查询 (en-US)字符串解析后的结果。返回的MediaQueryList 可被用于判定Document是否匹配媒体查询,或者监控一个document 来判定它匹配了或者停止匹配了此媒体查询。7 |" n' r4 d* f) V: |1 ]
4.2addListener()1 R. e! C9 x" U
MediaQueryList接口的addListener()方法向MediaQueryListener添加一个侦听器,该侦听器将运行自定义回调函数以响应媒体查询状态的更改。
0 n! d3 u! H$ c) V8 s& \JavaScript监听判断: p; k2 m6 y# Q& Q7 x) _6 }
const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)')
function darkModeHandler() {
if (mediaQuery.matches) {
console.log('现在是深色模式')
} else {
console.log('现在是浅色模式')
}
}
// 判断当前模式
darkModeHandler()
// 监听模式变化
mediaQuery.addListener(darkModeHandler)
|