【转载】Hexo博客Next主题添加暗黑夜间模式切换

使用hexo-next-darkmode​插件实现夜间模式切换。

安装

暗黑/夜间模式切换插件

1
npm install hexo-next-darkmode --save

配置

往 NexT 主题的 _config.yml​ 配置文件里添加以下内容,必须确保 NexT 原生的 darkmode​ 选项设置为 false

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# close NexT's darkmode
darkmode: false

# Darkmode JS
# For more information: https://github.com/rqh656418510/hexo-next-darkmode, https://github.com/sandoche/Darkmode.js
darkmode_js:
enable: true
bottom: '64px' # default: '32px'
right: 'unset' # default: '32px'
left: '32px' # default: 'unset'
time: '0.5s' # default: '0.3s'
mixColor: 'transparent' # default: '#fff'
backgroundColor: 'transparent' # default: '#fff'
buttonColorDark: '#100f2c' # default: '#100f2c'
buttonColorLight: '#dcdcdc' # default: '#fff'
saveInCookies: true # default: true
label: '🌓' # default: ''
autoMatchOsTheme: true # default: true
libUrl: # Set custom library cdn url for Darkmode.js

适用于 NexT 主题的暗黑/夜间模式切换插件,如果 NexT 的版本 < 8.2.0,则需要额外安装 Nunjucks 渲染插件,否则 hexo-next-darkmode​ 插件无法正常运行。


自定义样式

暗黑/夜间模式激活后,会将 darkmode--activated​ CSS 类添加到 body​ 标签,你可以利用它覆盖插件默认自带的样式(如下所示),这样就可以实现暗黑/夜间模式样式的高度自定义,包括代码块颜色自定义等。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
.darkmode--activated {
--body-bg-color: #282828;
--content-bg-color: #333;
--card-bg-color: #555;
--text-color: #ccc;
--blockquote-color: #bbb;
--link-color: #ccc;
--link-hover-color: #eee;
--brand-color: #ddd;
--brand-hover-color: #ddd;
--table-row-odd-bg-color: #282828;
--table-row-hover-bg-color: #363636;
--menu-item-bg-color: #555;
--btn-default-bg: #222;
--btn-default-color: #ccc;
--btn-default-border-color: #555;
--btn-default-hover-bg: #666;
--btn-default-hover-color: #ccc;
--btn-default-hover-border-color: #666;
--highlight-background: #282b2e;
--highlight-foreground: #a9b7c6;
--highlight-gutter-background: #34393d;
--highlight-gutter-foreground: #9ca9b6;
}

.darkmode--activated img {
opacity: 0.75;
}

.darkmode--activated img:hover {
opacity: 0.9;
}

.darkmode--activated code {
color: #69dbdc;
background: transparent;
}
  • 当某个标签不想使用暗黑/夜间模式时,可以添加 darkmode-ignore​ CSS 类到标签上。

<span class=“darkmode-ignore”>😬<span>

  • 当然你也可以使用 isolation: isolate;​ CSS 样式来忽略暗黑/夜间模式。

1
2
3
.button {
isolation: isolate;
}
  • 也可以使用这种 mix-blend-mode: difference​ CSS 样式来还原暗黑/夜间模式。

1
2
3
.button {
mix-blend-mode: difference;
}

参考

hexo-next-darkmode/README_CN.md at a2bce418a3df3a9a3409ce92e393cf5669647110 · rqh656418510/hexo-next-darkmode