H5 项目如何适配暗黑模式

一、背景

深色模式不仅可以大幅减少电量的消耗，减弱强光对比,还能 提供更好的可视性和沉浸感。 如何切换深色模式：

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

二、问题

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

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

1. 声明 color-scheme

   1.1. meta

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

   1.2. CSS

   :root {
       color-scheme: light dark;
   }
   

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

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

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

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

   1. matchMedia

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

   2. 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)