当前位置: 首页 > news >正文

【前端从0到1实战】第7篇:构建“深色模式切换”与本地存储 (Dark Mode LocalStorage)

欢迎来到本系列的第7篇。在之前的文章中,我们主要关注组件的内部逻辑。今天,我们将把视野扩大到整个网站的架构。

深色模式(Dark Mode)不仅仅是一个“开关”,它涉及到 CSS 架构设计的核心思想——变量化。同时,为了让网站“记住”用户的选择,我们将第一次接触浏览器的LocalStorage(本地存储)。

本篇我们将实现:

基于 CSS 变量 的主题系统。

一个平滑切换的“日/夜”开关。

使用 JS 读取和保存用户偏好。

第一部分:HTML 结构搭建 (语义化与开关)

HTML 结构相对简单。我们主要需要两部分:

页面内容:用于展示主题切换后的效果(如标题、卡片、文字)。

切换开关:一个用于触发切换的按钮。

<body>
<!-- 1. 顶部导航栏 -->
<nav class="navbar"><div class="logo">MyBrand</div><!-- 主题切换开关 aria-label 是为了无障碍访问--><button id="theme-toggle" class="theme-btn" aria-label="切换主题"><!-- 默认显示月亮图标 (代表点击进入深色模式) --><span class="icon">🌙</span><span class="text">深色模式</span></button>
</nav><!-- 2. 主要内容区域 -->
<main class="container"><div class="hero-section"><h1>欢迎来到我的博客</h1><p>这是一个演示 CSS 变量和深色模式切换的页面。</p></div><div class="card-grid"><!-- 卡片 1 --><div class="card"><h2>文章标题 1</h2><p>这是一些示例文本。在深色模式下,背景变黑,文字变白。</p><a href="#" class="link">阅读更多</a></div><!-- 卡片 2 --><div class="card"><h2>文章标题 2</h2><p>CSS 变量让这一切变得非常简单且高效。</p><a href="#" class="link">阅读更多</a></div></div></main>
</body>

第二部分:CSS 样式 (CSS 变量的魔力)

这是本篇的核心。我们不再直接写死颜色(如 #ffffff 或 #000000),而是定义变量。

逻辑如下:

在 :root (默认状态) 下定义一套“浅色”变量。

在 [data-theme="dark"] 状态下重新定义这套变量为“深色”值。

在具体的 CSS 规则中,只使用 var(--variable-name)。

/* --- 1. 定义变量系统 --- */

/* 默认 (浅色) 主题 /
:root {
/
背景色 */
--bg-body: #f4f7f6;
--bg-card: #ffffff;
--bg-nav: #ffffff;

/* 文本色 */
--text-primary: #333333;
--text-secondary: #666666;/* 强调色 */
--accent-color: #007bff;/* 边框与阴影 */
--border-color: #e1e4e8;
--shadow: 0 4px 12px rgba(0,0,0,0.08);

}

/* 深色主题 (通过 data-theme="dark" 属性激活) */
[data-theme="dark"] {
--bg-body: #1a1a1a;
--bg-card: #2d2d2d;
--bg-nav: #2d2d2d;

--text-primary: #ffffff;
--text-secondary: #b0b0b0;--accent-color: #4dabf7; /* 深色模式下通常颜色要稍微亮一点 */--border-color: #444444;
--shadow: 0 4px 12px rgba(0,0,0,0.3);

}

/* --- 2. 应用变量 --- */

body {
background-color: var(--bg-body);
color: var(--text-primary);
font-family: -apple-system, sans-serif;
/* 核心:添加 transition 让颜色切换平滑过渡 */
transition: background-color 0.3s ease, color 0.3s ease;
margin: 0;
}

.navbar {
background-color: var(--bg-nav);
border-bottom: 1px solid var(--border-color);
padding: 15px 30px;
display: flex;
justify-content: space-between;
align-items: center;
transition: background-color 0.3s ease, border-color 0.3s ease;
}

.card {
background-color: var(--bg-card);
border: 1px solid var(--border-color);
box-shadow: var(--shadow);
padding: 25px;
border-radius: 8px;
transition: background-color 0.3s ease, border-color 0.3s ease, box-shadow 0.3s ease;
}

.card h2 { margin-top: 0; }

.card p { color: var(--text-secondary); }

.link { color: var(--accent-color); text-decoration: none; }

/* --- 开关按钮样式 --- */
.theme-btn {
background: transparent;
border: 1px solid var(--border-color);
color: var(--text-primary);
padding: 8px 16px;
border-radius: 20px;
cursor: pointer;
display: flex;
align-items: center;
gap: 8px;
transition: all 0.3s ease;
}

.theme-btn:hover {
background-color: var(--bg-body);
}

/* 布局辅助 */
.container { max-width: 800px; margin: 40px auto; padding: 0 20px; }
.card-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 20px; }

第三部分:JS 交互逻辑 (LocalStorage)

JavaScript 的任务不仅仅是切换类名,更重要的是持久化用户的选择。

逻辑流程:

初始化:页面加载时,检查 localStorage。如果有保存的设置,立即应用。

切换:点击按钮时,切换 html 标签上的 data-theme 属性。

保存:将当前的状态('dark' 或 'light')写入 localStorage。

document.addEventListener('DOMContentLoaded', () => {

// 1. 获取 DOM 元素
const toggleBtn = document.getElementById('theme-toggle');
const toggleIcon = toggleBtn.querySelector('.icon');
const toggleText = toggleBtn.querySelector('.text');// 我们将把 data-theme 属性放在 <html> 标签上
const htmlElement = document.documentElement;// --- 辅助函数:更新按钮 UI ---
const updateButtonUI = (isDark) => {if (isDark) {toggleIcon.textContent = '☀';toggleText.textContent = '浅色模式';} else {toggleIcon.textContent = '🌙';toggleText.textContent = '深色模式';}
};// --- 2. 初始化:检查本地存储 ---
// 检查用户之前是否选过
const savedTheme = localStorage.getItem('myAppTheme');// 如果之前保存了 'dark',则立即应用
if (savedTheme === 'dark') {htmlElement.setAttribute('data-theme', 'dark');updateButtonUI(true);
} else {// 默认是浅色,无需操作 (或者也可以显式设置 'light')updateButtonUI(false);
}// --- 3. 绑定点击事件 ---
toggleBtn.addEventListener('click', () => {// 检查当前是否是深色模式const currentTheme = htmlElement.getAttribute('data-theme');if (currentTheme === 'dark') {// -> 切换为浅色htmlElement.setAttribute('data-theme', 'light');localStorage.setItem('myAppTheme', 'light'); // 保存到本地updateButtonUI(false);} else {// -> 切换为深色htmlElement.setAttribute('data-theme', 'dark');localStorage.setItem('myAppTheme', 'dark'); // 保存到本地updateButtonUI(true);}});

});

总结

恭喜!您构建了一个现代化的、具备记忆功能的深色模式系统。

我们学到了:

CSS 变量 (:root):这是现代 CSS 最强大的功能之一,它彻底改变了我们管理颜色的方式。

属性选择器 ([data-theme="..."]):利用 HTML 属性来驱动 CSS 样式的变化。

LocalStorage:如何使用简单的 setItem 和 getItem 让网页拥有“记忆”,极大地提升了用户体验。

这套逻辑是通用的,您可以将其应用到任何规模的 Web 项目中。

http://www.zskr.cn/news/61762.html

相关文章:

  • 【多所高校组织】第七届水利与土木建筑工程国际学术会议(HCCE 2025)
  • 2025年专业的信号发生器品牌TOP5推荐
  • 2025 年木塑地板厂家最新推荐,聚焦资质、案例、售后的五家品牌深度解读室外木塑地板厂家/共挤木塑地板厂家/wpc木塑地板厂家/防腐木塑地板厂家
  • Linux的进程控制 - 教程
  • 【webpack】Webpack 最常用的 20 道面试题总结 - 教程
  • 留学机构排行榜TOP10:2025申请季的黄金法则!
  • 2025年11月深圳装修设计公司最新推荐,办公室、酒店、展厅、写字楼、厂房、公寓、店铺工装装修多维度综合考量
  • 2025 最新制氧机经销商权威推荐:国际协会测评认证,聚焦品质与服务的靠谱选择云南制氧机/昆明制氧机/美之氧制氧机/映美制氧机/鱼跃制氧机公司推荐
  • 2025年效果好的助眠的口服液供货商权威推荐榜单:改善睡眠质量的产品‌/安神助眠的产品‌/效果好的助眠产品源头供货商精选
  • 【LVGL】消息框部件
  • 实用指南:Day49 | J.U.C集合-CopyOnWriteArrayList详解
  • 深度揭秘 HBase 协同机制:HMaster、RegionServer 与 ZooKeeper 的三角之恋
  • permutation
  • 2025英国留学机构十大口碑推荐榜!教育行业认证,唯寻国际教育摘冠
  • 中美电力对比
  • 推荐专业的北京离婚财产纠纷律师及相关法律服务参考
  • 北京离婚官司最厉害的律师有哪些?实务经验参考
  • 质量好的工业洗地机实用推荐指南
  • 2025堆垛机立体库厂家哪家好?最新堆垛机立体库制造商排名推荐与趋势综合分析
  • 推荐几家高温炉定制厂家,技术实力与服务解析
  • 2025年线性霍尔元件批发厂家权威推荐榜单:双极霍尔元件/微功耗霍尔元件/单极霍尔元件源头厂家精选
  • k8s event 单独存储一个etcd
  • 汽车小型打气泵方案
  • 仓储软件(WMS)哪家专业?行业热门选择解析
  • 《postman、apipost、smartApi 等使用与特点 3 天路线图(可打印 PDF+互动脑图)》
  • 2025年11月苗木批发基地推荐,紫薇/油松/丝棉木/樱花/红叶石楠/红叶李苗木基地
  • 基于MATLAB实现的克里金插值的代码
  • 年轻肌肤敏感泛红用什么?温和舒缓配方 年轻肌专属修护产品榜单
  • 2025年企业知识库本地化部署指南(11月更新):Deepseek技术赋能数据主权,含知识库部署厂商/服务商/方案商及AI/BI私有化部署厂商推荐
  • 2025 年 11 月广东注册公司服务品牌推荐:广州注册公司、广州外资公司、广东个体户、广州分公司注册选择指南