H5项目适配系统深色模式方案总结

爱被打了一巴掌 2022-11-18 13:57 296阅读 0赞

### 文章目录 ###

*  一、背景
 *  二、问题
 *  三、H5项目适配深色模式方案
 *   *  1.声明 color-scheme
     *   *  1.1meta
         *  1.2CSS
     *  2.通过 CSS 媒体查询
     *  3.图片适配
     *  4. JavaScript中判断当前模式&监听模式变化
     *   *  4.1matchMedia
         *  4.2addListener()
         *  JavaScript监听判断
 *  四、嵌入app的H5页面

# 一、背景 #

> 随着 iOS 13 的发布，深色模式（Dark Mode）越来越多地出现在大众的视野中，支持深色模式已经成为现代移动应用和网站的一个潮流，前段时间更是因为微信的适配再度引起热议。深色模式不仅可以大幅减少电量的消耗，减弱强光对比,还能 提供更好的可视性和沉浸感。

**如何切换深色模式**

*  iOS：“设置”–“显示与亮度”–“外观”，选择“深色”
 *  Android：“系统设置”–“显示”–“深色模式”。

# 二、问题 #

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

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

我尝试了一些方案：

# 三、H5项目适配深色模式方案 #

## 1.声明 color-scheme ##

[color-scheme][]

有两种方式。

### 1.1meta ###

在head中声明`<meta name="color-scheme" content="light dark">`，声明当前页面支持 light 和 dark 两种模式，系统切换到深色模式时，浏览器默认样式也会切换到深色；

### 1.2CSS ###

下面的 css 同样可以实现上面 meta 声明的效果

:root {
        color-scheme: light dark;
    }

> 注意：此声明并非为页面做自动适配，只影响浏览器默认样式
> 
> 更多信息可查阅 W3C 文档 [《CSS Color Adjustment Module Level 1》][CSS Color Adjustment Module Level 1]

## 2.通过 CSS 媒体查询 ##

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

*  no-preference  
    表示系统未得知用户在这方面的选项。在布尔值上下文中，其执行结果为 false。
 *  light  
    表示用户已告知系统他们选择使用浅色主题的界面。
 *  dark  
    表示用户已告知系统他们选择使用暗色主题的界面。

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

## 3.图片适配 ##

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

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

## 4. JavaScript中判断当前模式&监听模式变化 ##

### 4.1matchMedia ###

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

### 4.2addListener() ###

MediaQueryList接口的[addListener()][addListener]方法向MediaQueryListener添加一个侦听器，该侦听器将运行自定义回调函数以响应媒体查询状态的更改。

### JavaScript监听判断 ###

const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)')
    
    function darkModeHandler() {
        if (mediaQuery.matches) {
            console.log('现在是深色模式')
        } else {
            console.log('现在是浅色模式')
        }
    }
    
    // 判断当前模式
    darkModeHandler()
    // 监听模式变化
    mediaQuery.addListener(darkModeHandler)

# 四、嵌入app的H5页面 #

如果是嵌入app中的H5页面，还得相应的WebView提供支持，不然利用媒体查询可能会获取不到正确的结果。

[本文链接https://blog.csdn.net/qq\_39903567/article/details/115673247][https_blog.csdn.net_qq_39903567_article_details_115673247]

[color-scheme]: https://developer.mozilla.org/en-US/docs/Web/CSS/color-scheme
[CSS Color Adjustment Module Level 1]: https://drafts.csswg.org/css-color-adjust-1/
[prefers-color-scheme]: https://developer.mozilla.org/zh-CN/docs/Web/CSS/@media/prefers-color-scheme
[picture]: https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/picture
[matchMedia]: https://developer.mozilla.org/zh-CN/docs/Web/API/Window/matchMedia
[addListener]: https://developer.mozilla.org/zh-CN/docs/Web/API/MediaQueryList/addListener
[https_blog.csdn.net_qq_39903567_article_details_115673247]: https://blog.csdn.net/qq_39903567/article/details/115673247