HTML / CSS / 系统课时

实现响应式与暗色模式

实现响应式与暗色模式

本课为数据看板补齐两类全局适配:视口变化驱动布局重排,主题选择驱动明暗配色切换。完成后,页面会在手机、平板和桌面端保持清晰,并记住用户选择的主题。

学习目标

  • 用移动优先的响应式变体控制导航、侧栏和卡片列数。
  • 用根元素上的 dark 类作为唯一主题状态源,并持久化用户选择。
  • 为背景、文字、边框和交互状态建立成对的明暗样式。

统一两个状态源

响应式布局不需要 JavaScript 判断宽度,组件只需通过无前缀基础样式和 sm:、md:、lg:、xl: 变体逐级增强。暗色模式则由 html 根元素是否包含 dark 类决定,按钮和本地存储只负责更新这一处状态。

响应式断点与暗色主题状态流

这两个状态源应彼此独立:改变窗口宽度不修改主题,切换主题也不改布局结构。组件只消费状态,不自行保存偏好,因此不会出现某张卡片已变暗、导航仍停留在明亮模式的局部不一致。

完成可运行页面

将下面内容保存为 index.html 并用浏览器打开。@custom-variant 把 dark: 变体绑定到根元素的 .dark 类;初始化脚本优先读取已保存偏好,没有记录时再参考系统主题。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>响应式主题看板</title>
  <script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script>
  <style type="text/tailwindcss">
    @custom-variant dark (&:where(.dark, .dark *));
  </style>
  <script>
    // 在正文绘制前确定主题,减少初始明暗样式跳变。
    const savedTheme = localStorage.getItem("theme");
    const prefersDark = window.matchMedia("(prefers-color-scheme: dark)").matches;
    document.documentElement.classList.toggle(
      "dark",
      savedTheme ? savedTheme === "dark" : prefersDark
    );
  </script>
</head>
<body class="min-h-screen bg-slate-50 text-slate-900 transition-colors dark:bg-slate-950 dark:text-slate-100">
  <header class="border-b border-slate-200 bg-white dark:border-slate-800 dark:bg-slate-900">
    <div class="mx-auto flex max-w-6xl items-center justify-between px-4 py-4 sm:px-6 lg:px-8">
      <a href="#" class="font-bold text-sky-700 dark:text-sky-400">课程看板</a>
      <nav class="hidden gap-6 text-sm md:flex" aria-label="主导航">
        <a href="#" class="hover:text-sky-700 dark:hover:text-sky-400">概览</a>
        <a href="#" class="hover:text-sky-700 dark:hover:text-sky-400">学员</a>
        <a href="#" class="hover:text-sky-700 dark:hover:text-sky-400">课程</a>
      </nav>
      <button id="theme-toggle" type="button"
        class="rounded-lg border border-slate-300 px-3 py-2 text-sm font-medium hover:bg-slate-100 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-sky-500 dark:border-slate-700 dark:hover:bg-slate-800">
        切换主题
      </button>
    </div>
  </header>

  <main class="mx-auto grid max-w-6xl gap-6 px-4 py-6 sm:px-6 lg:grid-cols-[14rem_1fr] lg:px-8">
    <aside class="hidden rounded-xl border border-slate-200 bg-white p-4 lg:block dark:border-slate-800 dark:bg-slate-900">
      <p class="text-sm font-semibold">数据范围</p>
      <ul class="mt-3 space-y-2 text-sm text-slate-600 dark:text-slate-300">
        <li>本周学习</li>
        <li>课程完成率</li>
        <li>活跃学员</li>
      </ul>
    </aside>

    <section>
      <div class="mb-5">
        <p class="text-sm text-slate-500 dark:text-slate-400">2026 年第 32 周</p>
        <h1 class="mt-1 text-2xl font-bold sm:text-3xl">学习概览</h1>
      </div>

      <!-- 卡片列数随视口增强,配色随根元素主题同步切换 -->
      <div class="grid gap-4 sm:grid-cols-2 xl:grid-cols-3">
        <article class="rounded-xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
          <p class="text-sm text-slate-500 dark:text-slate-400">活跃学员</p>
          <p class="mt-2 text-3xl font-bold">86</p>
        </article>
        <article class="rounded-xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
          <p class="text-sm text-slate-500 dark:text-slate-400">平均进度</p>
          <p class="mt-2 text-3xl font-bold text-sky-700 dark:text-sky-400">68%</p>
        </article>
        <article class="rounded-xl border border-slate-200 bg-white p-5 shadow-sm dark:border-slate-800 dark:bg-slate-900">
          <p class="text-sm text-slate-500 dark:text-slate-400">本周完成</p>
          <p class="mt-2 text-3xl font-bold text-emerald-700 dark:text-emerald-400">24</p>
        </article>
      </div>

      <article class="mt-6 rounded-xl border border-slate-200 bg-white p-5 dark:border-slate-800 dark:bg-slate-900">
        <h2 class="font-semibold">最近活动</h2>
        <p class="mt-2 text-sm leading-6 text-slate-600 dark:text-slate-300">
          三名学员完成了响应式设计章节,两名学员开始暗色模式练习。
        </p>
      </article>
    </section>
  </main>

  <script>
    const root = document.documentElement;
    const toggleButton = document.querySelector("#theme-toggle");

    function renderThemeButton() {
      const dark = root.classList.contains("dark");
      toggleButton.textContent = dark ? "切换为明亮模式" : "切换为暗色模式";
      toggleButton.setAttribute("aria-pressed", String(dark));
    }

    toggleButton.addEventListener("click", () => {
      const nextDark = !root.classList.contains("dark");
      root.classList.toggle("dark", nextDark);
      localStorage.setItem("theme", nextDark ? "dark" : "light");
      renderThemeButton();
    });

    renderThemeButton();
  </script>
</body>
</html>

预期结果

text
手机宽度下隐藏主导航和侧栏,卡片单列显示;达到 md 后显示导航,达到 lg 后出现侧栏,达到 xl 后卡片变为三列。点击主题按钮后,页面背景、卡片、文字、边框和交互状态同步切换,刷新页面后仍保持上次选择。

组织明暗样式配对

暗色样式应按视觉职责配对,而不是机械地给每个类都添加 dark:。页面背景、卡片表面、主文字、次要文字、边框和强调色是六类核心令牌;例如 bg-white dark:bg-slate-900 负责表面,text-slate-500 dark:text-slate-400 负责次要信息。

交互状态同样需要成对检查。按钮在两种主题下都要有可辨识的悬停背景和键盘焦点;强调色在暗色背景上通常需要更亮的色阶。transition-colors 可以缓和切换,但不应给布局尺寸添加无关过渡,否则断点变化时会产生拖沓感。

验证与排障

依次把窗口调整到手机、平板和桌面宽度,检查导航、侧栏与卡片列数;再切换主题并刷新页面,确认偏好被恢复。清除站点的 localStorage 后重新载入,页面应回到系统偏好决定的初始主题。

若响应式类没有生效,先检查 viewport 元信息和类名前缀是否写在完整类名之前。若 dark: 完全无效,检查 @custom-variant dark 是否存在以及 .dark 是否加在祖先元素上。构建项目中不要用字符串动态拼接颜色类,应让完整类名出现在可扫描源码里。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现响应式与暗色模式

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通