React / 系统课时
使用全局样式
使用全局样式
本课将建立 App Router 项目的全局样式入口,统一盒模型、颜色变量、字体和页面基础规则。完成后,所有路由都能继承一致的视觉基线,同时组件细节仍可交给局部样式管理。
学习目标
- 在根布局中加载全局 CSS
- 使用 CSS 变量维护基础设计令牌
- 控制全局规则的作用范围
创建全局样式文件
在 app/globals.css 中放置真正需要覆盖整个应用的规则,例如重置、主题变量和 body 基础样式。
css
:root {
--color-bg: #f7f8fc;
--color-surface: #ffffff;
--color-text: #172033;
--color-primary: #4f46e5;
--page-max-width: 72rem;
}
* {
box-sizing: border-box;
}
html,
body {
margin: 0;
min-height: 100%;
}
body {
background: var(--color-bg);
color: var(--color-text);
font-family: Arial, sans-serif;
}
a {
color: inherit;
text-decoration: none;
}
.page-shell {
width: min(100% - 2rem, var(--page-max-width));
margin-inline: auto;
}生效行为:页面默认取消浏览器外边距,元素统一使用 border-box,背景色、文字色和最大内容宽度都从全局变量读取。开发者工具中检查 body 的计算样式即可验证。
在根布局中导入
全局样式通常只在根布局导入一次。根布局负责生成顶层 html 和 body,因此所有子路由都会获得这些规则。
tsx
import type { ReactNode } from 'react'
import './globals.css'
export default function RootLayout({
children,
}: Readonly<{ children: ReactNode }>) {
return (
<html lang="zh-CN">
<body>
<div className="page-shell">{children}</div>
</body>
</html>
)
}预期结果:启动项目并访问任意路由后,内容区域居中显示,左右至少保留一段间距,页面背景和文字颜色与 globals.css 中的变量一致。
管理变量与作用边界
用变量而不是复制数值
全局变量适合保存跨页面共享的颜色、间距和尺寸。组件样式通过 var(--color-primary) 引用它们,修改主题时只需调整一个入口。
变量名称应表达用途,不要只描述色值。--color-danger 比 --red-500 更容易体现业务语义;需要完整设计系统时,也可以同时保留基础色阶和语义变量。
避免全局规则污染组件
不要在全局文件中为普通组件定义大量通用类名,例如 .card、.title、.button。这些名字容易与第三方样式或后续页面冲突。
更稳妥的边界是:全局 CSS 管重置、主题和页面级通用结构;组件自己的布局、状态和变体使用 CSS Modules 或 Tailwind CSS。这样既保留统一基线,又减少远距离副作用。
按自己的节奏,确认真正理解。