H5 项目如何适配暗黑模式

背景

随着 iOS 13 的发布，深色模式（Dark Mode）越来越多地出现在大众的视野中，支持深色模式已经成为现代移动应用和网站的一个潮流。

优势

  • 可大幅减少耗电量（具体取决于设备的屏幕技术）。
  • 为弱视以及对强光敏感的用户提高可视性。
  • 让所有人都可以在光线较暗的环境中更轻松地使用设备。

系统兼容情况

  • macOS 10.14 引入了 darkmode
  • ios13 2019 年 3 月发布的 ios13 版本加入了 darkmode
  • Android 10 (API 级别 29) 及更高版本中提供深色主题背景
  • window10 2018.10.10

如何切换深色模式

  1. iOS：“设置”–“显示与亮度”–“外观”，选择“深色”

  2. Android：“系统设置”–“显示”–“深色模式”。

问题

如果系统设置了深色模式，H5页面不做相应的处理，会出现背景色冲突、深色文字显示异常，深色图标显示异常等一些显示上的问题。

所以，需要对深色模式进行一些适配。

原理

  1. 将同一个资源，创建出两种模式的样式。系统根据当前选择的样式，自动获取该样式的资源

  2. 每次系统更新样式时，应用会调用当前所有存在的元素调用对应的一些重新方法，进行重绘视图，可以在对应的方法做相应的改动

H5项目适配深色模式方案

  1. 声明 color-scheme
    color-scheme

有两种方式。

  • meta

在head中声明，声明当前页面支持 light 和 dark 两种模式，系统切换到深色模式时，浏览器默认样式也会切换到深色；

  • CSS
    下面的 css 同样可以实现上面 meta 声明的效果
1
2
3
:root {
    color-scheme: light dark;
}

注意：此声明并非为页面做自动适配，只影响浏览器默认样式

  1. 通过 CSS 媒体查询

prefers-color-scheme CSS 媒体特性用于检测用户是否有将系统的主题色设置为亮色或者暗色。

no-preference
表示系统未得知用户在这方面的选项。在布尔值上下文中，其执行结果为 false。

light
表示用户已告知系统他们选择使用浅色主题的界面。

dark
表示用户已告知系统他们选择使用暗色主题的界面。

1
2
3
4
5
6
7
8
9
10
11
12
:root {
    color-scheme: light dark;
    background: white;
    color: black;
}

@media (prefers-color-scheme: dark) {
    :root {
        background: black;
        color: white;
    }
}

[参考](MDN prefers-color-scheme)

颜色较多的情况，建议使用CSS变量对颜色值进行管理

  1. 图片适配

利用picture+source标签，设置不同模式下的图片 url。

HTML 元素通过包含零或多个 元素和一个 元素来为不同的显示/设备场景提供图像版本。浏览器会选择最匹配的子 元素，如果没有匹配的，就选择 元素的 src 属性中的URL。然后，所选图像呈现在元素占据的空间中。

1
2
3
4
5
6
<picture>
    <!-- 深色模式下的图片 -->
    <source srcset="dark.jpg" media="(prefers-color-scheme: dark)" />
    <!-- 默认模式下的图片 -->
    <img src="light.jpg"/>
</picture>
  1. JavaScript中判断当前模式&监听模式变化
  • matchMedia

Window 的matchMedia() 方法返回一个新的MediaQueryList 对象，表示指定的媒体查询 (en-US)字符串解析后的结果。返回的MediaQueryList 可被用于判定Document是否匹配媒体查询，或者监控一个document 来判定它匹配了或者停止匹配了此媒体查询。

  • addListener()
    MediaQueryList接口的addListener()方法向MediaQueryListener添加一个侦听器，该侦听器将运行自定义回调函数以响应媒体查询状态的更改。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// JavaScript监听判断
const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)')

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

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