使用 Gatsby.js 搭建静态博客黑暗模式

2024-01-16 07:58

本文主要是介绍使用 Gatsby.js 搭建静态博客黑暗模式,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

来源 | https://ssshooter.com/2020-06-25-gatsby-blog-8/

没想到久违的 Gatsby 系列还能继续写,最近为博客更新了黑暗模式和手动切换功能,顺便记录下来。当然下面的实现方案不限于 Gatsby 使用,对于其他框架,思路都大同小异。

方案 1

最初实现的方案是直接使用媒体查询和 css 变量。关键是把区分两个模式的变量抽离出来,分别配置两组变量,核心代码如下:

@media screen and (prefers-color-scheme: dark) {  :root {    --linkColor: #ec9bab;    --fontColor: #ecc3cb;    --codeBlock: #3c495b;    --code: #c3c7cb;    --divider: #3e4b5e;  }}@media screen and (prefers-color-scheme: light) {  :root {    --linkColor: #683741;    --fontColor: hsl(284, 20%, 30%);    --codeBlock: #3c495b;    --code: #c3c7cb;    --divider: #eee;  }}body {  background-color: var(--backgroundColor);  color: var(--fontColor);  transition: all 0.5s ease-in-out;}

(prism 用户还要自己整理一下两个模式的 prism 样式)

css 变量除了在 IE 不能用之外其他浏览器的适应性还算不错,如果必须适配 IE 的话需要另外写一份不用变量的样式保底。

方案 2

按上面的写法其实已经可以实现根据系统配置转换明亮和黑暗模式,但是要做到直接在网页通过一个切换按钮手动修改还是远远不够,方案 2 登场。

因为现在 JavaScript 不能改变系统级的明暗模式,只能获取和监听模式变化,所以手动操作铁定不能靠 prefers-color-scheme 了。

我们需要反过来通过 JavaScript 获取 color-scheme 然后告诉 CSS 明暗模式发生变化,这样的变化包括系统级的改变和用户在网页选择改变。

首先把两组变量的作用范围改为 class:

.light-theme {  --linkColor: #ec9bab;  --fontColor: #ecc3cb;  --codeBlock: #3c495b;  --code: #c3c7cb;  --divider: #3e4b5e;}.dark-theme {  --linkColor: #683741;  --fontColor: hsl(284, 20%, 30%);  --codeBlock: #3c495b;  --code: #c3c7cb;  --divider: #eee;}

下面这一段代码我写在 Layout.js 的 componentDidMount 中,只有这里才是服务器渲染的范围之外。

// setTheme 的实现setTheme = themeName => {  localStorage.setItem('theme', themeName)  document.documentElement.className = themeName + '-theme'  this.setState({    theme: themeName,  })}// 第一部分let localTheme = localStorage.getItem('theme')if (localTheme) {  if (localTheme === 'dark') {    this.setTheme('dark')  } else {    this.setTheme('light')  }} else if (window.matchMedia) {  if (window.matchMedia('(prefers-color-scheme: dark)').matches) {    this.setTheme('dark')  } else {    this.setTheme('light')  }} else {  // default light  this.setTheme('light')}// 第二部分const darkModeMediaQuery = window.matchMedia('(prefers-color-scheme: dark)')darkModeMediaQuery.addListener(e => {  const darkModeOn = e.matches  if (darkModeOn) {    this.setTheme('dark')  } else {    this.setTheme('light')  }})

先讲 setTheme 的实现:

数据持久化

实现设置整个文档的 class,然后 CSS 根据 class 配置变量(而不是方案 1 的媒体查询)

修改组件状态

第一部分是页面初始化时处理页面主题的逻辑:

首先查询有无被保存到 localstorage 的主题,有的话直接使用

没有的话使用 JavaScript 查询系统明暗方案,然后按系统配置设定

上面两种都不可行的情况下默认使用 light

第二部分是 JavaScript 监听系统明暗方案修改,响应式地改变页面的明暗方案(意味着不需要刷新页面)

剩下的切换按钮就没什么特别的,所以不放代码了。

hack

最后附带一个处理画面闪烁的方法。

虽然已经在样式添加 transition 属性,但是从 JavaScript 程序知道用户需要的明暗模式前仍然有一段空挡。如果用户选择了黑暗模式,就会造成画面先是明亮模式,然后几百毫秒后变为黑暗模式的尴尬局面。

我的解决方案是先把页面 display 设为 none,在判断并设置完页面 class 之后再将页面设为可见,这样就避免了画面闪烁,但是页面展示时间会慢一点点点点。

document.documentElement.style.display = 'none'// 同步的判断程序document.documentElement.style.display = 'block'

本文完〜

这篇关于使用 Gatsby.js 搭建静态博客黑暗模式的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/611830

相关文章

C#使用yield关键字实现提升迭代性能与效率

《C#使用yield关键字实现提升迭代性能与效率》yield关键字在C#中简化了数据迭代的方式,实现了按需生成数据,自动维护迭代状态,本文主要来聊聊如何使用yield关键字实现提升迭代性能与效率,感兴... 目录前言传统迭代和yield迭代方式对比yield延迟加载按需获取数据yield break显式示迭

使用SQL语言查询多个Excel表格的操作方法

《使用SQL语言查询多个Excel表格的操作方法》本文介绍了如何使用SQL语言查询多个Excel表格,通过将所有Excel表格放入一个.xlsx文件中,并使用pandas和pandasql库进行读取和... 目录如何用SQL语言查询多个Excel表格如何使用sql查询excel内容1. 简介2. 实现思路3

java脚本使用不同版本jdk的说明介绍

《java脚本使用不同版本jdk的说明介绍》本文介绍了在Java中执行JavaScript脚本的几种方式,包括使用ScriptEngine、Nashorn和GraalVM,ScriptEngine适用... 目录Java脚本使用不同版本jdk的说明1.使用ScriptEngine执行javascript2.

c# checked和unchecked关键字的使用

《c#checked和unchecked关键字的使用》C#中的checked关键字用于启用整数运算的溢出检查,可以捕获并抛出System.OverflowException异常,而unchecked... 目录在 C# 中,checked 关键字用于启用整数运算的溢出检查。默认情况下,C# 的整数运算不会自

在MyBatis的XML映射文件中<trim>元素所有场景下的完整使用示例代码

《在MyBatis的XML映射文件中<trim>元素所有场景下的完整使用示例代码》在MyBatis的XML映射文件中,trim元素用于动态添加SQL语句的一部分,处理前缀、后缀及多余的逗号或连接符,示... 在MyBATis的XML映射文件中,<trim>元素用于动态地添加SQL语句的一部分,例如SET或W

Mybatis官方生成器的使用方式

《Mybatis官方生成器的使用方式》本文详细介绍了MyBatisGenerator(MBG)的使用方法,通过实际代码示例展示了如何配置Maven插件来自动化生成MyBatis项目所需的实体类、Map... 目录1. MyBATis Generator 简介2. MyBatis Generator 的功能3

Python中使用defaultdict和Counter的方法

《Python中使用defaultdict和Counter的方法》本文深入探讨了Python中的两个强大工具——defaultdict和Counter,并详细介绍了它们的工作原理、应用场景以及在实际编... 目录引言defaultdict的深入应用什么是defaultdictdefaultdict的工作原理

使用Python进行文件读写操作的基本方法

《使用Python进行文件读写操作的基本方法》今天的内容来介绍Python中进行文件读写操作的方法,这在学习Python时是必不可少的技术点,希望可以帮助到正在学习python的小伙伴,以下是Pyth... 目录一、文件读取:二、文件写入:三、文件追加:四、文件读写的二进制模式:五、使用 json 模块读写

Python使用qrcode库实现生成二维码的操作指南

《Python使用qrcode库实现生成二维码的操作指南》二维码是一种广泛使用的二维条码,因其高效的数据存储能力和易于扫描的特点,广泛应用于支付、身份验证、营销推广等领域,Pythonqrcode库是... 目录一、安装 python qrcode 库二、基本使用方法1. 生成简单二维码2. 生成带 Log

Python如何使用seleniumwire接管Chrome查看控制台中参数

《Python如何使用seleniumwire接管Chrome查看控制台中参数》文章介绍了如何使用Python的seleniumwire库来接管Chrome浏览器,并通过控制台查看接口参数,本文给大家... 1、cmd打开控制台,启动谷歌并制定端口号,找不到文件的加环境变量chrome.exe --rem