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 且配置好暗色触发策略的页面模板。示例同时覆盖容器、文字、边框、按钮悬停和键盘聚焦。
<!-- 卡片表面、边框和主文字在两种主题下成对变化 -->
<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>预期结果
浅色默认:白色卡片、深色主文字、浅灰边框。
暗色默认:slate-900 卡片、浅色主文字、slate-700 边框。
鼠标悬停:按钮在当前主题中变为更明显的相邻色阶。
键盘聚焦:按钮出现带偏移的焦点环,且不会与背景混在一起。检查关键边界
切换主题后,先检查页面大表面,再检查卡片、弹窗和输入框等局部表面,最后检查悬停、聚焦、禁用和选中状态。只给容器添加 dark:bg-* 而遗漏文字与边框,是最常见的不完整改造。
不要只在一种主题下验收组件。至少使用鼠标和键盘各操作一次,并观察链接、按钮和表单控件的焦点是否可见。浏览器开发工具可临时切换根元素上的 dark 类,帮助快速逐项核对。