ALL NOTES

LAB NOTES / 2026.10.20

深淺色模式|善用深淺色模式,降低視覺疲勞

其實一開始在開發 TaskTimer 工具時,我並沒有覺得深淺色切換是一定要加入的功能。

平時我自己的使用習慣,大部分都是維持在淺色模式;只有在兩種特定情境下例外– 一個是使用 VS Code 寫程式的時候,另一個則是看手機的時候。

會這樣是因為:

  • 在用 VS Code 寫程式或整理 code 時,通常會盯著螢幕看很久,如果用淺色模式,眼睛會很容易感到疲勞。

  • 手機的話,則是因為環境光源不充足,如果開著淺色模式,有時候感覺像看到 「聖光」。

TaskTimer 一開始是為了學習程式而動手打造的小工具。常常一邊開著深色的 VS Code 寫code,轉頭看旁邊正在測試的淺色計時畫面,高對比的畫面很容易造成視覺疲勞,因此為了避免這種情況,最終還是決定為它加上深淺色模式。


什麼是深淺色模式?

深淺色模式指的是網頁能夠根據使用者的偏好或環境光源,動態切換介面的色彩配置。

  • 淺色模式(Light Mode):以明亮的背景(如白色、淺灰)搭配深色文字,視覺上乾淨清爽,適合在光線充足的白天使用。

  • 深色模式(Dark Mode):以深色背景(如深灰、墨黑)搭配淺色文字,能大幅降低螢幕在暗光環境下的刺眼感。

如何實作深淺色模式?

在現代前端開發中,最主流的做法是利用 CSS 變數 搭配 JavaScript 來控制。

1. 用 CSS 變數建立色彩系統

可以先在 :root 定義預設的顏色變數,再透過一個 .dark 類別來覆寫深色模式下的顏色:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
/* 預設為淺色模式變數 */
:root {
--bg-color: #ffffff;
--text-color: #222222;
--primary-color: #4a90e2;
}

/* 深色模式變數 */
body.dark {
--bg-color: #1a1a1a;
--text-color: #f0f0f0;
--primary-color: #64b5f6;
}

/* 實際套用 */
body {
background-color: var(--bg-color);
color: var(--text-color);
transition: background-color 0.3s, color 0.3s; /* 讓切換時有平滑的漸變效果 */
}

2. 用 JavaScript 輕鬆切換

搭配 JavaScript,只要在使用者點擊按鈕時,幫 <body> 加上或移除 .dark 類別,並用 localStorage 把選擇記下來即可:

1
2
3
4
5
6
7
8
9
10
const themeToggleBtn = document.querySelector('#theme-toggle');

themeToggleBtn.addEventListener('click', () => {
// 切換 dark 類別
document.body.classList.toggle('dark');

// 記錄使用者的偏好到 localStorage
const isDark = document.body.classList.contains('dark');
localStorage.setItem('theme', isDark ? 'dark' : 'light');
});

如何實作深淺色模式?(使用Bootstrap)

因為我的專案裡本來就有使用Bootstrap,所以我是使用它的原生模式支援。如果你的專案也有使用Bootstrap,可以考慮下面的做法。

1. 使用 Bootstrap 的 data-bs-theme 屬性

只要在整份文件的最外層(例如 標籤)加上屬性 data-bs-theme="dark" 或 data-bs-theme="light",整頁的顏色就會自動切換。如果想要自訂或覆寫某些深色模式下的顏色,就可以直接在 CSS 裡使用屬性選擇器:

1
2
3
4
5
/* 自訂你在深色模式下想覆寫的樣式或變數 */
[data-bs-theme="dark"] {
--bs-body-bg: #1a1a1a;
--bs-body-color: #f0f0f0;
}

在 HTML 標籤上直接切換:

1
2
<!-- 切換成深色模式 -->
<html lang="zh-Hant" data-bs-theme="dark">

2.用 JavaScript 切換與儲存

搭配 JavaScript,只要在使用者點擊按鈕時,去動態修改 <html> 的 data-bs-theme 屬性,並用 localStorage 把使用者的選擇記下來即可:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
const themeToggleBtn = document.querySelector('#theme-toggle');
const htmlElement = document.documentElement; // 取得 <html> 標籤

themeToggleBtn.addEventListener('click', () => {
// 檢查目前是 dark 還是 light
const currentTheme = htmlElement.getAttribute('data-bs-theme');
const newTheme = currentTheme === 'dark' ? 'light' : 'dark';

// 設定新的屬性
htmlElement.setAttribute('data-bs-theme', newTheme);

// 記錄使用者的偏好到 localStorage
localStorage.setItem('theme', newTheme);
});

實作時的小細節

1. 圖片與圖示的隱形危機:

有些 PNG 圖示或 SVG 圖標,如果顏色剛好是深色的,切換到深色背景時就會直接消失或是效果不好。所以也要留意,改為深色模式後,這些圖片與圖示是否需要做調整。

2. 重整時的畫面閃爍(FOUC):

FOUC 的全名是 Flash of Unstyled Content(中文常翻譯為「無樣式內容閃爍」)。

當瀏覽器載入網頁時,如果 HTML 結構先下載完成,但 CSS 樣式表還沒下載好(或正在解析),瀏覽器就會先用預設的樣式把畫面渲染出來。等到 CSS 一載入,畫面才突然「閃」變成正確的樣式。

這時必須在 HTML 的 <head> 裡先用一小段 JavaScript 腳本,在畫面渲染前就讀取 localStorage 並套用類別,才能解決這個閃爍的小瑕疵。

所有筆記