一、背景
深色模式不仅可以大幅减少电量的消耗,减弱强光对比,还能 提供更好的可视性和沉浸感。 如何切换深色模式:
- iOS:“设置”--“显示与亮度”--“外观”,选择“深色”。
- Android:“系统设置”--“显示”--“深色模式”。
二、问题
如果系统设置了深色模式,H5页面不做相应的处理,会出现背景色冲突、深色文字显示异常,深色图标显示异常等一些显示上的问题。
三、H5项目适配深色模式方案
-
声明 color-scheme
1.1. meta
在head中声明<meta name="color-scheme" content="light dark">,声明当前页面支持 light 和 dark 两种模式,系统切换到深色模式时,浏览器默认样式也会切换到深色;
1.2. CSS
:root { color-scheme: light dark; }
注意:此声明并非为页面做自动适配,只影响浏览器默认样式
-
通过 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变量对颜色值进行管理
-
-
图片适配
利用picture+source标签,设置不同模式下的图片 url。
HTML 元素通过包含零或多个 元素和一个 元素来为不同的显示/设备场景提供图像版本。浏览器会选择最匹配的子 元素,如果没有匹配的,就选择 元素的 src 属性中的URL。然后,所选图像呈现在元素占据的空间中。
<picture> <!-- 深色模式下的图片 --> <source srcset="dark.jpg" media="(prefers-color-scheme: dark)" /> <!-- 默认模式下的图片 --> <img src="light.jpg"/> </picture>
-
JavaScript中判断当前模式&监听模式变化
-
matchMedia
Window 的matchMedia() 方法返回一个新的MediaQueryList 对象,表示指定的媒体查询 (en-US)字符串解析后的结果。返回的MediaQueryList 可被用于判定Document是否匹配媒体查询,或者监控一个document 来判定它匹配了或者停止匹配了此媒体查询。
-
addListener()
MediaQueryList接口的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)
-