H5 项目如何适配暗黑模式

admin

一、背景
       随着 iOS 13 的发布，深色模式（Dark Mode）越来越多地出现在大众的视野中，支持深色模式已经成为现代移动应用和网站的一个潮流，前段时间更是因为微信的适配再度引起热议。深色模式不仅可以大幅减少电量的消耗，减弱强光对比,还能 提供更好的可视性和沉浸感。
4 ?6 n+ k- h: {! B6 g% Z* t如何切换深色模式
3 F  [" t# D7 T5 X+ U: M

• iOS：“设置”--“显示与亮度”--“外观”，选择“深色”
• Android：“系统设置”--“显示”--“深色模式”。
  * X, Z3 c# m/ H& w

二、问题
1 R& P7 @5 J0 v! h8 _- I       如果系统设置了深色模式，H5页面不做相应的处理，会出现背景色冲突、深色文字显示异常，深色图标显示异常等一些显示上的问题。
       所以，需要对深色模式进行一些适配。
三、H5项目适配深色模式方案
8 @& C& ~  g, g' f7 W. T3 u1.声明 color-scheme
( c6 h, R0 ?( v       color-scheme有两种方式。
" ~) w: @+ J) a2 ~) D0 w2 V1.1meta
2 ]" `) W5 b6 L        在head中声明<meta name="color-scheme" content="light dark">，声明当前页面支持 light 和 dark 两种模式，系统切换到深色模式时，浏览器默认样式也会切换到深色；
5 q% y4 l) S. x; Y1.2CSS
        下面的 css 同样可以实现上面 meta 声明的效果
8 a; x( b/ d$ Z& Y2 r, B8 r" B8 x

复制代码
:root {
    color-scheme: light dark;
}

      注意：此声明并非为页面做自动适配，只影响浏览器默认样式，更多信息可查阅 W3C 文档 《CSS Color Adjustment Module Level 1》
, d4 r4 p9 k1 D* f; ?2.通过 CSS 媒体查询
; {; v- ]6 E+ J       prefers-color-scheme CSS 媒体特性用于检测用户是否有将系统的主题色设置为亮色或者暗色。
( d$ @9 G: D- W# ?

• no-preference 表示系统未得知用户在这方面的选项。在布尔值上下文中，其执行结果为 false。
• light 表示用户已告知系统他们选择使用浅色主题的界面。
• dark 表示用户已告知系统他们选择使用暗色主题的界面。
  , u9 X, m9 b. z2 w/ P8 F

复制代码
:root {
    color-scheme: light dark;
    background: white;
    color: black;
}

@media (prefers-color-scheme: dark) {
    :root {
        background: black;
        color: white;
    }
}
//颜色较多的情况，建议使用CSS变量对颜色值进行管理

3.图片适配
) f2 t# Q! N0 W4 k1 r+ S! F( j       利用picture+source标签，设置不同模式下的图片 url。
: |$ x' e) \, _6 l       HTML <picture>元素通过包含零或多个 <source> 元素和一个 <img> 元素来为不同的显示/设备场景提供图像版本。浏览器会选择最匹配的子 <source> 元素，如果没有匹配的，就选择 <img> 元素的 src 属性中的URL。然后，所选图像呈现在<img>元素占据的空间中。

复制代码
<picture>
    <!-- 深色模式下的图片 -->
    <source srcset="dark.jpg" media="(prefers-color-scheme: dark)" />
    <!-- 默认模式下的图片 -->
    <img src="light.jpg"/>
</picture>

4. JavaScript中判断当前模式&监听模式变化
- \, m' Q/ k8 C4 W4.1matchMedia
       Window 的matchMedia() 方法返回一个新的MediaQueryList 对象，表示指定的媒体查询 (en-US)字符串解析后的结果。返回的MediaQueryList 可被用于判定Document是否匹配媒体查询，或者监控一个document 来判定它匹配了或者停止匹配了此媒体查询。
' p8 f# `% f! C) x$ j1 O" |4.2addListener()
       MediaQueryList接口的addListener()方法向MediaQueryListener添加一个侦听器，该侦听器将运行自定义回调函数以响应媒体查询状态的更改。
, l/ T2 c$ j2 h% i8 fJavaScript监听判断

复制代码
const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)')

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

// 判断当前模式
darkModeHandler()
// 监听模式变化
mediaQuery.addListener(darkModeHandler)