用tailwindcss适配暗黑模式竟如此简单

简介: 接着上面一篇《从Nuxt文档里发现色彩的配搭诀窍》的内容,本文是我继续对 Nuxt/Content 的探索。当我研究它的色彩系统的时候,我还发现它还提供了暗黑模式,这也算是色彩系统的一种吧,毕竟也是和色彩搭配有关。经过一番学习折腾之后发现它的暗黑模式实现非常简单,甚至不需要你对这个模式有多么深刻的理解,只需要设置几个选项就能完成,并且搭配了 tailwindcss 的 color 系统灵活性也非常的好。

接着上面一篇《从Nuxt文档里发现色彩的配搭诀窍》的内容,本文是我继续对 Nuxt/Content 的探索。当我研究它的色彩系统的时候,我还发现它还提供了暗黑模式,这也算是色彩系统的一种吧,毕竟也是和色彩搭配有关。经过一番学习折腾之后发现它的暗黑模式实现非常简单,甚至不需要你对这个模式有多么深刻的理解,只需要设置几个选项就能完成,并且搭配了 tailwindcss 的 color 系统灵活性也非常的好。


本文就以 引发作者探索暗黑模式的背景 -> 暗黑模式起源以及重要性 -> tailwindcss + vue3 实践暗黑模式的思路来进行讲解。


image.png


首先我们先来通过 html 源码看看整个页面的样式变化。


image.png


image.png


从 切换到黑暗模式下的class 的内容就可以看出来,与普通模式相比会有两个变化:


1.根元素会挂载一个 dark-mode 的样式。

2.任何设置了 dark:{class} 的样式会生效。


没错,这就是 tailwindcss 内置的 dark mode,根据模式切换,能自动往根元素插入一个class,并且让 我们一开始设置的dark:{class}生效 ,大概的原理我们懂了,就差实践了,那么在进入实践之前,先来聊聊,为什么会有暗黑模式?当前以下不仅会回答这个问题,我还会解释为什么要用暗黑模式。


起因



让我们开始吧!


在计算机诞生早期的时候,计算机的显示屏其实一直被「暗黑模式」所占据,这是因为在20世纪60~80年代的计算机显示器使用的是仅能支持单色显示的阴极射线管(CRT),黑底绿字的展示方式就成为了当时的常态。(原来这是一直延续的传统~)


image.png


即使是80年代之后,彩色CRT显示器逐渐流行普及,但当时主流的DOS并没有什么「图形界面」的概念,依然延续了先前黑底的习惯。直到1984年,苹果发布了个人计算机Macintosh,普及了图形用户界面(Graphic User Interface)的概念,从而开启了以白色为底色的图形交互时代。


image.png


直到2019年10月, IOS 13 这一支持暗黑模式系统的发布,「Dark Mode」的热度达到了空前的顶峰。


image.png


然后各大互联网APP进行适配「暗黑模式」,可以从下图看出来~(图来自优设),其实我们也有感受,自从那以后周围很多人的屏幕都变成了暗黑的主题。到这里为止我们阐述了为什么有暗黑模式这个问题,其实一直都有,只不过自从苹果发布了之后,得到了大家的广泛关注。


image.png


再来看看近几年的《移动互联网行业分析报告》分析中,可以看出,越来越多的人选择在夜间/较为昏暗的场景下使用手机


image.png


image.png


许多视频APP的高峰使用时段大部分处于 20:00 到 22:00 ,并且像快手、抖音短视频APP的兴起也使得大家普遍晚睡了。因此夜间场景使用增长了大家对「暗黑模式」的需求,因此各大厂商为了吸引人们使用产品的欲望,自然要适配暗黑模式。这一模式不仅能够让我们不再眼瞎,并且能够带来视觉沉浸感。


下面我们回归到我们的正题,通过一个新的项目来讲解 **tailwindcss 适配「暗黑模式」**这一过程。


实践



本次实践,我采用 vue3 创建的 demo 作为例子。(其他框架也是类似,只需要配置对应的 loader)


我们就直接通过 tailwindcss 官网提供的 vue3 + vite 的命令来新建项目(https://tailwindcss.com/docs/guides/vue-3-vite


# 创建项目
npm init vite my-project
cd my-project
# 安装依赖
npm install
# 安装 tailwind 依赖
npm install -D tailwindcss@latest postcss@latest autoprefixer@latest


# tailwind 配置初始化
npx tailwindcss init -p


初始化后,会自动在目录下创建两个文件, tailwind.config.jspostcss.config.js ,这个时候我们的文件目录呈现以下的样子。


./
├── README.md
├── index.html
├── package-lock.json
├── package.json
├── postcss.config.js
├── public
│   └── favicon.ico
├── src
│   ├── App.vue
│   ├── assets
│   ├── components
│   └── main.js
├── tailwind.config.js
└── vite.config.js


然后为了能够使用 tailwindcss ,我们还需要引入他的一些工具包。我们通过在src目录下创建一个 index.css 来引入它的工具包。


# 创建 tailwindcss
touch src/index.css


修改我们的 css 文件,引入工具包:


// src/index.css
@tailwind base;
@tailwind components;
@tailwind utilities;


然后在入口文件 main.js 引入这个css文件。


// src/main.js
import { createApp } from 'vue'
import App from './App.vue'
import './index.css'
createApp(App).mount('#app')


至此我们的 vite + vue3 + tailwindcss 的工程已经初始化好了,接下来就是需要配置 tailwindcss 的暗黑模式了。


一共需要两个步骤,第一步是选择使用的模式,第二步是为了能方便写适配暗黑模式的代码,例如dark:{class}


第一步


打开 tailwind.config.js 文件,我们来修改最外层的 darkMode属性,它有两个选项 mediaclass


  1. media是通过媒体监测实时监测用户操作系统上是否启用了暗模式。
  2. class更偏向于手动,例如在站点提供选项或按钮来切换light和dark模式。


在这里我们使用 class模式 来实现我们的暗黑模式。


...
darkMode: "class"
...


第二步


在 tailwindcss 中如果需要支持暗黑模式,还需要在 variants 中增加配置,例如以下我们让背景色和文字颜色支持了暗黑模式。


继续编写 tailwind.config.js, 增加 variants,这一步主要是增加了一些能让你快速书写暗黑模式的class代码,例如,dark:text-gray-300 ,意思就是在暗黑模式下,让文字呈现灰度为 300 的颜色。关于这个数值,可以看我上一篇文章《从Nuxt文档里发现色彩的配搭诀窍》,这是 tailwindcss 的一套主题色值,数值越小,代表颜色越来越浅,越接近白色,色值越大代表颜色越深,越接近白色。因此我们需要在暗黑模式下选择一个颜色较浅的色彩值。暗黑模式下一共有以下几个属性可以配置成快速书写的方式, backgroundColor, borderColor, gradientColorStops,

placeholderColortextColor。那为什么要配置这一步呢?其实主要和代码量有关,配置多个属性势必会引入更多的css类,如果你的暗黑模式无使用到所有的类,那么只需要适量引入。


// tailwind.config.js
module.exports = {
  ...
  variants: {
    extend: {
      textOpacity: ['dark'],
      backgroundColor: ['dark'],
    }
  }
  ...
}


然后再增加一个支持暗黑模式的插件tailwindcss-dark-mode


const colors = require('tailwindcss/colors')
const plugin = require('tailwindcss/plugin')
const selectorParser = require('postcss-selector-parser')
module.exports = {
  // purge: ['./index.html', './src/**/*.{vue,js,ts,jsx,tsx}'],
  darkMode: "class", // or 'media' or 'class'
  theme: {
    colors,
    extend: {},
  },
  variants: {
    extend: {
      backgroundColor: ['dark'],
      textColor: ['dark'],
    },
  },
  plugins: [
    require('tailwindcss-dark-mode')()
  ],
}


然后我们在 App.vue 中写入我们的控制主题代码


<div class="text-gray-700 dark:text-gray-300 dark:bg-gray-900 w-full h-full">
    <button @click="lightMode" class="border-2 p-1 m-1">普通模式</button>
    <button @click="darkMode" class="border-2 p-1 m-1">暗黑模式</button>
    <div class="p-1">
      <h1 class="text-2xl">我是H1</h1>
      <h2 class="text-xl">我是H2</h2>
      <h3 class="text-lg">我是H3</h3>
      <h4 class="">我是H4</h4>
    </div>
</div>


当我们处于暗黑模式的时候,我们将字体的颜色改成了 text-gray-300,并且将背景色改成了bg-gray-900,查看一下效果:


image.png


以上代码可以在 https://github.com/hua1995116/dark-mode 获取。、


总结



其实我们发现通过这种方式来写暗黑模式,非常的简单,只需要在一些关键的元素前面添加 dark 就能轻松适配暗黑模式,不再需要想一个类名,并且在媒体查询中写下我们对应的代码,整体的流程都变得简单的。


感谢



以上我们通过了 探索暗黑模式的背景 -> 暗黑模式起源以及重要性 -> tailwindcss + vue3 实践暗黑模式的思路向大家讲解了如何用 tailwindcss 适配 暗黑模式,最初的起源只是因为想找到一个文档站点,因此找到了 nuxt/content,后来慢慢去探索它其中闪光点,也告诉了我们一个道理,当我们在使用一些优秀项目的时候,如果我们稍加细心,只要再往内部探索一些,就能学习到非常多有价值的知识。在使用和探索中学习,岂不快哉~


参考文章



http://www.199it.com/archives/1010486.html

https://finance.sina.com.cn/tech/2021-05-06/doc-ikmxzfmm0820987.shtml

https://www.uisdc.com/dark-mode-history

https://trends.google.com/trends/explore?date=all&geo=HK&q=Dark%20Mode

https://tailwindcss.com/docs/dark-mode

相关文章
|
7月前
|
前端开发
三种方式实现主题切换方案
三种方式实现主题切换方案
vue2实现markdown编辑器,实现同步滚动,实时预览等功能
vue2实现markdown编辑器,实现同步滚动,实时预览等功能
|
10天前
Next.js 实战 (三):优雅的实现暗黑主题模式
这篇文章介绍了在Next.js中实现暗黑模式的具体步骤。首先,需要安装next-themes库。然后,在/components/ThemeProvider/index.tsx文件中新增ThemeProvider组件,并在/app/layout.tsx文件中注入该组件。如果想要加入过渡动画,可以修改代码实现主题切换时的动画效果。最后,需要在需要的位置引入ThemeModeButton组件,实现暗黑模式的切换。
|
4月前
|
前端开发 JavaScript
移动端适配方案,基于postcss
【8月更文挑战第9天】
94 2
|
6月前
Nuxt3 实战 (八):优雅的实现暗黑主题模式
这篇文章介绍了在Nuxt3中实现暗黑模式的过程。首先推荐使用color-mode库来轻易实现暗黑模式切换,并通过pnpm命令安装@nuxtjs/color-mode依赖。然后在nuxt.config.ts配置文件中注入依赖,并根据项目实际情况自定义配置。接着通过toggleDark函数实现切换动画,并在需要的地方加载组件<ColorMode/>,从而达到最终效果。
180 3
Nuxt3 实战 (八):优雅的实现暗黑主题模式
|
7月前
|
小程序 JavaScript
【微信小程序】之自定义四宫格(不用mp-grids扩展组件实现,这个组件太难用了)
【微信小程序】之自定义四宫格(不用mp-grids扩展组件实现,这个组件太难用了)
|
前端开发
Concis组件库 | 暗黑模式设计
Concis已开工半年时间,开源免费,欢迎大家体验、一起折腾。你可以通过以下方式来支持作者。
116 1
Concis组件库 | 暗黑模式设计
|
开发工具 iOS开发 开发者
iOS 暗黑模式的适配总结
iOS 暗黑模式的适配总结
|
自然语言处理 编译器 C#
【WPF】实现动态切换语言(国际化)以及动态换肤功能
以下内容,手把手从搭建到最终实现,完成多语言切换以及换装功能。
463 0
【WPF】实现动态切换语言(国际化)以及动态换肤功能
|
JavaScript 前端开发 小程序
为 TDesignBlazor 添加暗黑模式
本文将讲述我为 TDesignBlazor 开源项目提交 PR 的经历,主要介绍暗黑模式功能的实现以及之后如何在项目中使用。我将会分享我在实现这一功能时遇到的问题,以及我是如何解决这些问题的。我希望通过我的经历能够鼓励更多的人参与开源项目,为 TDesignBlazor 贡献代码,帮助项目快速迭代。
238 0
为 TDesignBlazor 添加暗黑模式