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。这样既保留统一基线,又减少远距离副作用。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用全局样式

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

登录哪都通