H5 項目適配系統深色模式方案

一、背景

隨着 iOS 13 的發佈,深色模式(Dark Mode)越來越多地出現在大衆的視野中,支持深色模式已經成爲現代移動應用和網站的一個潮流,前段時間更是因爲微信的適配再度引起熱議。深色模式不僅可以大幅減少電量的消耗,減弱強光對比, 還能 提供更好的可視性和沉浸感。

如何切換深色模式

二、問題

如果系統設置了深色模式,H5 頁面不做相應的處理,會出現背景色衝突、深色文字顯示異常,深色圖標顯示異常等一些顯示上的問題。

所以,需要對深色模式進行一些適配。

我嘗試了一些方案:

三、H5 項目適配深色模式方案

  1. 聲明 color-scheme

color-scheme

有兩種方式。

1.1meta

在 head 中聲明<meta >,聲明當前頁面支持 light 和 dark 兩種模式,系統切換到深色模式時,瀏覽器默認樣式也會切換到深色;

1.2CSS

下面的 css 同樣可以實現上面 meta 聲明的效果

:root {
    color-scheme: light dark;
}

注意:此聲明並非爲頁面做自動適配,隻影響瀏覽器默認樣式

更多信息可查閱 W3C 文檔 《CSS Color Adjustment Module Level 1》

  1. 通過 CSS 媒體查詢

prefers-color-scheme CSS 媒體特性用於檢測用戶是否有將系統的主題色設置爲亮色或者暗色。

表示系統未得知用戶在這方面的選項。在布爾值上下文中,其執行結果爲 false。

表示用戶已告知系統他們選擇使用淺色主題的界面。

表示用戶已告知系統他們選擇使用暗色主題的界面。

:root {
    color-scheme: light dark;
    background: white;
    color: black;
}

@media (prefers-color-scheme: dark) {
    :root {
        background: black;
        color: white;
    }
}
//顏色較多的情況,建議使用CSS變量對顏色值進行管理
  1. 圖片適配

利用 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>
  1. JavaScript 中判斷當前模式 & 監聽模式變化

4.1matchMedia

Window 的 matchMedia() 方法返回一個新的 MediaQueryList 對象,表示指定的媒體查詢 (en-US) 字符串解析後的結果。返回的 MediaQueryList 可被用於判定 Document 是否匹配媒體查詢,或者監控一個 document 來判定它匹配了或者停止匹配了此媒體查詢。

4.2addListener()

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)

關於本文

作者:OmniDebug

原文:https://juejin.cn/post/6949433236787298335

本文由 Readfog 進行 AMP 轉碼,版權歸原作者所有。
來源https://mp.weixin.qq.com/s/szKBM5Pw3Hq8khEJfZt3GA