HTML / CSS / 系统课时

编写暗色模式样式

编写暗色模式样式

暗色主题不是把白色统一替换成黑色,而是为页面表面、文字层级、边框和交互状态建立一套对应关系。本课使用 dark: 变体改造一张内容卡片,并验证普通、悬停和键盘聚焦状态在两种主题下都清晰可辨。

学习目标

  • 为背景、文字和边框编写成对的基础样式与暗色样式。
  • 组合 dark:、hover: 和 focus-visible: 处理交互状态。
  • 通过可见结果检查对比度、层级和焦点反馈是否完整。

建立成对的明暗样式

先写浅色基础类,再用 dark: 覆盖需要变化的属性。例如 bg-white dark:bg-slate-900 控制表面,text-slate-900 dark:text-slate-100 控制主要文字,border-slate-200 dark:border-slate-700 控制边界。

暗色组件的基础与交互状态

颜色应按语义层级配对,而不是逐个机械反相。主要文字需要最高对比度,说明文字可稍弱,边框只需帮助识别区域。若暗色背景、次要文字和边框都过亮,页面会失去层级并产生刺眼感。

补齐交互状态

悬停、聚焦和禁用状态不会自动从浅色主题推导出来。hover:bg-slate-100 dark:hover:bg-slate-700 表示同时满足“暗色主题”和“鼠标悬停”时使用深色悬停背景;dark:focus-visible:ring-sky-400 则为暗色背景提供更清晰的键盘焦点环。

交互变化应保持克制。颜色切换可使用 transition-colors,但不要用 transition-all 无差别动画尺寸、位置和阴影。焦点状态还要配合 ring-offset,并让偏移区域颜色与当前页面背景一致,避免焦点环被暗色表面吞没。

主示例与预期结果

下面是片段示例,需要放入已经启用 Tailwind CSS 且配置好暗色触发策略的页面模板。示例同时覆盖容器、文字、边框、按钮悬停和键盘聚焦。

html
<!-- 卡片表面、边框和主文字在两种主题下成对变化 -->
<article class="rounded-xl border border-slate-200 bg-white p-6 text-slate-900 shadow-sm transition-colors dark:border-slate-700 dark:bg-slate-900 dark:text-slate-100">
  <p class="text-sm font-medium text-sky-700 dark:text-sky-400">课程更新</p>
  <h2 class="mt-2 text-xl font-semibold">暗色模式与主题定制</h2>

  <!-- 次要文字使用较弱但仍可读的对比度 -->
  <p class="mt-3 text-sm leading-6 text-slate-600 dark:text-slate-300">
    学习如何让组件在浅色、暗色和交互状态下保持清晰层级。
  </p>

  <!-- 暗色悬停和焦点环必须单独补齐 -->
  <a class="mt-5 inline-flex rounded-lg border border-slate-300 bg-slate-50 px-4 py-2 text-sm font-medium text-slate-800 transition-colors hover:bg-slate-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-sky-500 focus-visible:ring-offset-2 focus-visible:ring-offset-white dark:border-slate-600 dark:bg-slate-800 dark:text-slate-100 dark:hover:bg-slate-700 dark:focus-visible:ring-sky-400 dark:focus-visible:ring-offset-slate-900" href="#">
    查看详情
  </a>
</article>

预期结果

text
浅色默认:白色卡片、深色主文字、浅灰边框。
暗色默认:slate-900 卡片、浅色主文字、slate-700 边框。
鼠标悬停:按钮在当前主题中变为更明显的相邻色阶。
键盘聚焦:按钮出现带偏移的焦点环,且不会与背景混在一起。

检查关键边界

切换主题后,先检查页面大表面,再检查卡片、弹窗和输入框等局部表面,最后检查悬停、聚焦、禁用和选中状态。只给容器添加 dark:bg-* 而遗漏文字与边框,是最常见的不完整改造。

不要只在一种主题下验收组件。至少使用鼠标和键盘各操作一次,并观察链接、按钮和表单控件的焦点是否可见。浏览器开发工具可临时切换根元素上的 dark 类,帮助快速逐项核对。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写暗色模式样式

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

登录哪都通