暗黑模式切换与媒体查询设置教程

今天golang学习网给大家带来了《HTML暗黑模式切换与媒体查询设置详解》，其中涉及到的知识点包括等等，无论你是小白还是老手，都适合看一看哦~有好的建议也欢迎大家在评论留言，若是看完有所收获，也希望大家能多多点赞支持呀！一起加油学习~

答案：通过CSS媒体查询检测系统偏好，结合JavaScript实现手动切换与本地存储。使用prefers-color-scheme区分亮暗色主题，data-theme属性控制样式，localStorage保存用户选择，支持自动、亮色、暗色三种模式，并通过过渡动画和预设主题避免闪屏，确保体验流畅。

实现暗黑模式切换和根据用户偏好自动适配，主要依靠 HTML、CSS 和 JavaScript 的结合使用，配合 媒体查询（media query） 检测用户的系统偏好。下面介绍完整实现方法。

1. 使用 prefers-color-scheme 媒体查询

示例代码：

@media (prefers-color-scheme: light) {
  :root {
    --bg-color: #ffffff;
    --text-color: #000000;
  }
}

@media (prefers-color-scheme: dark) {
  :root {
    --bg-color: #1a1a1a;
    --text-color: #f0f0f0;
  }
}

2. 添加手动切换按钮（JavaScript 控制）

HTML 结构：

切换暗黑模式

CSS 设置数据属性控制主题：

[data-theme="light"] {
  --bg-color: #ffffff;
  --text-color: #000000;
}

[data-theme="dark"] {
  --bg-color: #1a1a1a;
  --text-color: #f0f0f0;
}

body {
  background-color: var(--bg-color);
  color: var(--text-color);
  transition: background-color 0.3s ease;
}

JavaScript 实现切换逻辑：

const toggleButton = document.getElementById('theme-toggle');
const currentTheme = localStorage.getItem('theme') || 'auto'; // 默认自动

// 应用主题
function applyTheme(theme) {
  if (theme === 'auto') {
    document.body.removeAttribute('data-theme');
    // 使用媒体查询判断
    const systemPrefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
    document.body.setAttribute('data-theme', systemPrefersDark ? 'dark' : 'light');
  } else {
    document.body.setAttribute('data-theme', theme);
  }
}

// 切换按钮点击事件
toggleButton.addEventListener('click', () => {
  const current = localStorage.getItem('theme') || 'auto';
  let nextTheme;

  if (current === 'light') {
    nextTheme = 'dark';
  } else if (current === 'dark') {
    nextTheme = 'auto';
  } else {
    nextTheme = 'light';
  }

  localStorage.setItem('theme', nextTheme);
  applyTheme(nextTheme);
});

// 页面加载时初始化
applyTheme(currentTheme);

// 监听系统主题变化（当设置为 auto 时生效）
window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', e => {
  const current = localStorage.getItem('theme');
  if (current === 'auto') {
    applyTheme('auto');
  }
});

3. 完整流程说明

• 自动（auto）：跟随系统主题，利用 prefers-color-scheme
• 亮色（light）：强制浅色模式
• 暗色（dark）：强制深色模式

4. 提示与优化建议

• 给 body 加上过渡动画，颜色切换更平滑
• 在页面加载前通过内联 script 预设 data-theme，避免闪屏
• 按钮文字可动态显示当前状态，如“切换到亮色”

理论要掌握，实操不能落！以上关于《暗黑模式切换与媒体查询设置教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！