React / 系统课时

样式组织与主题变量

样式组织与主题变量

样式工程化的核心是让颜色、间距和布局规则有统一来源,同时把组件细节限制在局部范围。本课将建立“设计变量、全局基础、组件样式”三层结构,并完成亮暗主题切换与响应式卡片布局。

学习目标

  • 能区分设计变量、全局样式和组件局部样式的职责
  • 能使用 CSS 自定义属性实现主题切换
  • 能用响应式规则保证不同屏幕下的布局可用

建立三层样式结构

设计变量集中保存颜色、间距、圆角等可复用值;全局样式负责重置、字体和页面背景;组件样式只描述当前组件的结构与状态。三层分开后,改主题不必逐个搜索颜色值,改组件也不会污染其他页面。

React 样式层级与主题变量数据流图

推荐把变量命名成语义角色,例如 --color-surface 和 --color-text,不要直接命名为 --white、--black。语义变量在暗色主题中可以替换实际色值,而组件代码无需变化。

定义主题与响应式规则

下面的 styles.css 同时包含基础变量、暗色覆盖、全局样式和卡片局部样式。data-theme 放在根元素上,媒体查询只负责改变布局,不重复主题色。

css
: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。

tsx
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>
  );
}

预期结果

text
桌面宽度下显示三列卡片,窄屏下自动变为单列。
点击主题按钮后,页面背景、卡片背景、文字和按钮主色同步切换。
再次点击后恢复亮色主题。

组件只关心主题状态和业务结构,颜色值全部由 CSS 变量控制。后续增加品牌主题时,只需新增一组变量覆盖,不必修改每个组件的样式声明。

控制局部样式的边界

全局样式应尽量少,只保留重置、字体、页面背景和通用变量。具体组件的布局、状态和内部选择器应放在组件样式文件或 CSS Modules 中,避免 .title、.item 这类过于宽泛的全局类名互相覆盖。

局部样式仍应消费全局变量,而不是重复写颜色和间距。这样既能隔离选择器,又能保持视觉一致。只有真正跨组件复用的规则,才适合提升为公共工具类或设计变量。

内容 推荐位置 原因
品牌色、间距、圆角 设计变量 多组件共享且会随主题变化
字体、页面背景、重置 全局样式 对整个应用生效
卡片内部布局与状态 局部样式 只影响当前组件
断点下的组件排版 组件附近 便于和结构一起维护

验证主题与响应式效果

验证时至少覆盖三种情况:亮色桌面、暗色桌面和窄屏。主题切换后检查文本对比度、按钮可读性与卡片边界;缩小视口后检查内容是否溢出、交互控件是否仍可点击。

若主题切换只改变部分区域,先检查这些区域是否写死了颜色。若移动端仍保持多列,检查媒体查询是否被更高优先级规则覆盖,以及样式文件是否已正确导入。

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

目录与阅读设置

阅读设置

17

记录一个想法

样式组织与主题变量

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

登录哪都通