React / 系统课时
样式组织与主题变量
样式组织与主题变量
样式工程化的核心是让颜色、间距和布局规则有统一来源,同时把组件细节限制在局部范围。本课将建立“设计变量、全局基础、组件样式”三层结构,并完成亮暗主题切换与响应式卡片布局。
学习目标
- 能区分设计变量、全局样式和组件局部样式的职责
- 能使用 CSS 自定义属性实现主题切换
- 能用响应式规则保证不同屏幕下的布局可用
建立三层样式结构
设计变量集中保存颜色、间距、圆角等可复用值;全局样式负责重置、字体和页面背景;组件样式只描述当前组件的结构与状态。三层分开后,改主题不必逐个搜索颜色值,改组件也不会污染其他页面。

推荐把变量命名成语义角色,例如 --color-surface 和 --color-text,不要直接命名为 --white、--black。语义变量在暗色主题中可以替换实际色值,而组件代码无需变化。
定义主题与响应式规则
下面的 styles.css 同时包含基础变量、暗色覆盖、全局样式和卡片局部样式。data-theme 放在根元素上,媒体查询只负责改变布局,不重复主题色。
:root {
--color-bg: #f5f7fb;
--color-surface: #ffffff;
--color-text: #1f2937;
--color-primary: #2563eb;
--color-on-primary: #ffffff;
--space-2: 0.5rem;
--space-4: 1rem;
--radius-md: 0.75rem;
}
:root[data-theme="dark"] {
--color-bg: #111827;
--color-surface: #1f2937;
--color-text: #f9fafb;
--color-primary: #60a5fa;
--color-on-primary: #111827;
}
* {
box-sizing: border-box;
}
body {
margin: 0;
background: var(--color-bg);
color: var(--color-text);
font-family: system-ui, sans-serif;
}
.page {
width: min(960px, 100% - 2rem);
margin: 0 auto;
padding: var(--space-4) 0;
}
.toolbar {
display: flex;
justify-content: flex-end;
margin-bottom: var(--space-4);
}
.card-grid {
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: var(--space-4);
}
.card {
padding: var(--space-4);
background: var(--color-surface);
border-radius: var(--radius-md);
}
button {
padding: var(--space-2) var(--space-4);
color: var(--color-on-primary);
background: var(--color-primary);
border: 0;
border-radius: var(--radius-md);
cursor: pointer;
}
@media (max-width: 720px) {
.card-grid {
grid-template-columns: 1fr;
}
}生效行为:默认使用亮色变量;根元素存在 data-theme="dark" 时覆盖为暗色变量;视口宽度不超过 720 像素时,三列卡片改为单列。可通过浏览器开发者工具检查根元素属性和计算后的变量值。
在组件中切换主题
下面的组件通过更新 document.documentElement.dataset.theme 切换根元素属性。示例假设上一节的 CSS 保存为同目录 styles.css。
import { useEffect, useState } from "react";
import "./styles.css";
const CARDS = ["订单管理", "用户中心", "数据报表"];
export default function App() {
const [theme, setTheme] = useState<"light" | "dark">("light");
useEffect(() => {
document.documentElement.dataset.theme = theme;
}, [theme]);
function toggleTheme() {
setTheme((current) => (current === "light" ? "dark" : "light"));
}
return (
<main className="page">
<div className="toolbar">
<button type="button" onClick={toggleTheme}>
切换为{theme === "light" ? "暗色" : "亮色"}主题
</button>
</div>
<section className="card-grid" aria-label="功能入口">
{CARDS.map((title) => (
<article className="card" key={title}>
<h2>{title}</h2>
<p>这里展示模块摘要。</p>
</article>
))}
</section>
</main>
);
}预期结果
桌面宽度下显示三列卡片,窄屏下自动变为单列。
点击主题按钮后,页面背景、卡片背景、文字和按钮主色同步切换。
再次点击后恢复亮色主题。组件只关心主题状态和业务结构,颜色值全部由 CSS 变量控制。后续增加品牌主题时,只需新增一组变量覆盖,不必修改每个组件的样式声明。
控制局部样式的边界
全局样式应尽量少,只保留重置、字体、页面背景和通用变量。具体组件的布局、状态和内部选择器应放在组件样式文件或 CSS Modules 中,避免 .title、.item 这类过于宽泛的全局类名互相覆盖。
局部样式仍应消费全局变量,而不是重复写颜色和间距。这样既能隔离选择器,又能保持视觉一致。只有真正跨组件复用的规则,才适合提升为公共工具类或设计变量。
| 内容 | 推荐位置 | 原因 |
|---|---|---|
| 品牌色、间距、圆角 | 设计变量 | 多组件共享且会随主题变化 |
| 字体、页面背景、重置 | 全局样式 | 对整个应用生效 |
| 卡片内部布局与状态 | 局部样式 | 只影响当前组件 |
| 断点下的组件排版 | 组件附近 | 便于和结构一起维护 |
验证主题与响应式效果
验证时至少覆盖三种情况:亮色桌面、暗色桌面和窄屏。主题切换后检查文本对比度、按钮可读性与卡片边界;缩小视口后检查内容是否溢出、交互控件是否仍可点击。
若主题切换只改变部分区域,先检查这些区域是否写死了颜色。若移动端仍保持多列,检查媒体查询是否被更高优先级规则覆盖,以及样式文件是否已正确导入。