Dark Mode Toggle 项目教程
2024-09-15 06:29:58作者:房伟宁
1. 项目介绍
Dark Mode Toggle 是一个由 Google Chrome Labs 开发的开源项目,旨在帮助开发者轻松地在网站上添加一个暗模式切换按钮。这个自定义元素允许你根据用户的系统偏好设置暗模式,同时也可以让用户手动选择并记住他们的偏好设置。
项目的主要功能包括:
- 根据
prefers-color-scheme
媒体查询自动检测用户的系统偏好。 - 允许用户手动切换暗模式和亮模式。
- 使用本地存储(localStorage)记住用户的偏好设置。
- 提供多种样式和自定义选项,如切换按钮的外观和图标。
2. 项目快速启动
安装
你可以通过 npm 安装这个项目:
npm install --save dark-mode-toggle
或者直接在 HTML 文件中使用 <script type="module">
标签引入:
<script type="module" src="https://unpkg.com/dark-mode-toggle"></script>
使用
以下是一个简单的示例,展示如何在你的网站中使用 dark-mode-toggle
元素。
HTML
<head>
<link rel="stylesheet" href="common.css" />
<link rel="stylesheet" href="light.css" media="(prefers-color-scheme: light)" />
<link rel="stylesheet" href="dark.css" media="(prefers-color-scheme: dark)" />
<script type="module" src="https://unpkg.com/dark-mode-toggle"></script>
</head>
<body>
<main>
<h1>Hi there</h1>
<p>Check out the dark mode toggle in the upper right corner</p>
</main>
<aside>
<dark-mode-toggle id="dark-mode-toggle-1" legend="Theme Switcher" appearance="switch" dark="Dark" light="Light" remember="Remember this"></dark-mode-toggle>
</aside>
</body>
CSS
:root {
--grid-unit: 1rem;
--border-radius-base: 0.5rem;
}
[data-theme="light"] {
--color-bg: #ffffff;
--color-fg: #000000;
}
[data-theme="dark"] {
--color-bg: #000000;
--color-fg: #ffffff;
}
body {
background-color: var(--color-bg);
color: var(--color-fg);
}
3. 应用案例和最佳实践
应用案例
- 博客网站:在博客网站中使用暗模式切换按钮,可以让用户在夜间阅读时减少眼睛疲劳。
- 企业官网:企业官网可以通过暗模式切换按钮提供更好的用户体验,尤其是对于需要在不同环境下浏览网站的用户。
- 开发工具:开发工具网站可以通过暗模式切换按钮提供更符合开发者习惯的界面,提高工作效率。
最佳实践
- 保持一致性:确保在暗模式和亮模式下,网站的整体风格和布局保持一致,避免用户在切换模式时感到不适。
- 优化性能:使用不同的样式表文件来加载暗模式和亮模式的样式,避免不必要的资源加载。
- 提供反馈:在用户切换模式时,提供视觉反馈,如按钮的动画效果,以增强用户体验。
4. 典型生态项目
- Google Chrome Labs:这个项目是由 Google Chrome Labs 开发的,展示了如何在现代浏览器中使用自定义元素和媒体查询来实现暗模式切换。
- W3Schools:W3Schools 提供了详细的教程和示例,帮助开发者理解和使用
dark-mode-toggle
元素。 - GitHub:GitHub 上有许多开源项目使用
dark-mode-toggle
元素,开发者可以通过查看这些项目的源码来学习如何在自己的项目中应用。
通过以上步骤,你可以轻松地将暗模式切换功能集成到你的网站中,提供更好的用户体验。
热门项目推荐
- 国产编程语言蓝皮书《国产编程语言蓝皮书》-编委会工作区017
- nuttxApache NuttX is a mature, real-time embedded operating system (RTOS).C00
- qwerty-learner为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workersTSX027
- 每日精选项目🔥🔥 01.17日推荐:一个开源电子商务平台,模块化和 API 优先🔥🔥 每日推荐行业内最新、增长最快的项目,快速了解行业最新热门项目动态~~026
- Cangjie-Examples本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。Cangjie045
- 毕方Talon工具本工具是一个端到端的工具,用于项目的生成IR并自动进行缺陷检测。Python039
- PDFMathTranslatePDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译,支持 Google/DeepL/Ollama/OpenAI 等服务,提供 CLI/GUI/DockerPython05
- mybatis-plusmybatis 增强工具包,简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.comJava03
- advanced-javaAdvanced-Java是一个Java进阶教程,适合用于学习Java高级特性和编程技巧。特点:内容深入、实例丰富、适合进阶学习。JavaScript0108
- taro开放式跨端跨框架解决方案,支持使用 React/Vue/Nerv 等框架来开发微信/京东/百度/支付宝/字节跳动/ QQ 小程序/H5/React Native 等应用。 https://taro.zone/TypeScript09
热门内容推荐
最新内容推荐
项目优选
收起
Python-100-Days
Python - 100天从新手到大师
Python
263
54
国产编程语言蓝皮书
《国产编程语言蓝皮书》-编委会工作区
65
17
open-eBackup
open-eBackup是一款开源备份软件,采用集群高扩展架构,通过应用备份通用框架、并行备份等技术,为主流数据库、虚拟化、文件系统、大数据等应用提供E2E的数据备份、恢复等能力,帮助用户实现关键数据高效保护。
HTML
85
63
openHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
53
44
Cangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
196
45
HarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
268
69
xxl-job
XXL-JOB是一个分布式任务调度平台,其核心设计目标是开发迅速、学习简单、轻量级、易扩展。现已开放源代码并接入多家公司线上产品线,开箱即用。
Java
9
0
RuoYi-Vue
🎉 基于SpringBoot,Spring Security,JWT,Vue & Element 的前后端分离权限管理系统,同时提供了 Vue3 的版本
Java
171
41
RuoYi-Cloud-Vue3
🎉 基于Spring Boot、Spring Cloud & Alibaba、Vue3 & Vite、Element Plus的分布式前后端分离微服务架构权限管理系统
Vue
38
24
qwerty-learner
为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers
TSX
332
27