zl程序教程

您现在的位置是:首页 >  前端

当前栏目

Web前端H5项目适配暗黑模式

H5项目Web模式前端 适配 暗黑
2023-09-14 09:16:29 时间

背景

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

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

H5项目适配深色模式方案

声明 color-scheme

  • 有两种方式

meta

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

CSS

/*
	此声明并非为页面做自动适配,只影响浏览器默认样式
	需要了解更多可查看 W3C 文档 《CSS Color Adjustment Module Level 1》
*/
:root {
    color-scheme: light dark;
}

通过 CSS 媒体查询

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

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

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

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

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

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

图片适配

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

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

<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)
  • 希望对你有帮助哦 😃😃😃

在这里插入图片描述