使用 10 行 JavaScript 代码实现基于用户操作系统偏好的明暗主题切换

20240824_ff9007b6070dce6b2be48fb735a43b1b.png

引言

在当今的 Web 开发中,为用户提供个性化体验已成为一种标准做法。其中一个流行的趋势就是支持暗模式,因为它不仅有助于节省电池电量,还能减轻长时间使用屏幕带来的视觉疲劳。在这篇文章中,我们将介绍如何使用简单的 JavaScript 代码和 CSS 来根据用户的操作系统偏好自动切换网站的主题,并允许用户手动在明暗模式之间切换。

目标

我想要实现什么?
我试图用这种方法实现两件事。

  1. 我需要允许网站以用户喜欢的方式加载(他们已经在操作系统中选择了主题的部分)
  2. 但我还想允许他们在加载后在暗模式和亮模式之间切换。

因此,我们将有一个网站,可以加载用户期望的主题,然后允许他们在需要时进行更改。

实现步骤

步骤 1: 创建切换按钮

首先,我们需要在 HTML 中添加一个按钮或图标作为切换主题的触发器。

<button class="mode" aria-label="Toggle Theme">
    <img src="./yueliang.png">
</button>

我使用的图片作为按钮,其中包含月亮的 svg 图片。您可以添加按钮或复选框,以便在两个选项之间切换。

步骤 2: 将颜色详细信息作为自定义属性放入 CSS 中

接下来,我们需要在 CSS 中定义主题相关的颜色,并使用 color-scheme 属性来指定配色方案。我们将使用 light-dark() 函数来根据用户的偏好自动选择颜色:

:root {
  color-scheme: light dark;
  --light-bg: ghostwhite;
  --light-color: darkslategray;
  --light-code: tomato;
  --dark-bg: darkslategray;
  --dark-color: ghostwhite;
  --dark-code: gold;
}

body {
  background-color: light-dark(var(--light-bg), var(--dark-bg));
  color: light-dark(var(--light-color), var(--dark-color));
}

code {
  color: light-dark(var(--light-code), var(--dark-code));
}

/* 用于区分明暗模式 */
.light {
  color-scheme: light;
}

.dark {
  color-scheme: dark;
}

好的,所以在:root中你会看到名为的属性color-scheme,这将是我们的游戏规则改变者。
如你所见,它接受值light或dark。我还创建了两个类,.light它们.dark将配色方案的值设置为深色或浅色。

步骤 3: 为代码的各个部分添加颜色

body{
    background-color: light-dark(var(--light-bg), var(--dark-bg));
}
...

现在,每当属性要求颜色时(例如background,color属性),您都可以使用名为的函数light-dark()【MDN官方文档
此函数采用两个值,第一个值在color-scheme设置为时使用,第二个值在设置为暗light时使用color-scheme

步骤 4: 使用 JavaScript 在明暗模式间切换

最后,我们需要编写 JavaScript 代码来监听按钮点击事件,并根据用户的系统偏好或当前状态切换主题:

const modeButton = document.querySelector('.mode');

modeButton.addEventListener('click', function () {
  const theme = document.documentElement.style.colorScheme;
  
  if (theme === null) {
    // 判断用户的系统偏好
    if (window.matchMedia('(prefers-color-scheme: dark)').matches) {
      // 用户偏好暗模式
      document.documentElement.style.colorScheme = 'light';
    } else {
      // 用户偏好亮模式
      document.documentElement.style.colorScheme = 'dark';
    }
  } else {
    // 根据当前模式切换
    document.documentElement.style.colorScheme = (theme === 'light') ? 'dark' : 'light';
  }
});

这里,document.documentElement.style.colorScheme其实是指:rootCSS中的元素。
正如我们在上一步中已经实现以用户首选模式打开网站一样,当单击切换按钮时,它会执行以下工作。

它检查配色方案是否有任何值,如果没有,则网站处于用户首选模式,我们需要确定它是暗还是亮来更改模式。
它用于window.matchMedia("(prefers-color-scheme:dark)").matches查找它是否处于暗模式,如果处于暗模式,我们将配色方案更改为light,如果不是,我们将其更改为dark。
下次他们点击按钮时,我们已经为配色方案设置了值,因此我们只需在深色或浅色之间切换。

实现效果

960_1724504485 2.gif

结论

通过以上步骤,我们成功实现了根据用户操作系统偏好自动加载明暗主题,并提供了一个简单的按钮让用户可以自由切换主题。这种方法既简单又高效,只需要少量的代码即可实现。如果你正在寻找一种轻量级的方式来为你的网站添加主题切换功能,那么这种方法将是一个不错的选择。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,558评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,002评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,036评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,024评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,144评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,255评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,295评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,068评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,478评论 1 305
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,789评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,965评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,649评论 4 336
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,267评论 3 318
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,982评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,223评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,800评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,847评论 2 351

推荐阅读更多精彩内容