React / 系统课时

集成 Tailwind CSS

集成 Tailwind CSS

本课将按当前 App Router 项目的方式接入 Tailwind CSS,并使用原子化工具类完成一张响应式课程卡片。你将同时掌握 PostCSS 配置、全局入口和断点前缀的基本用法。

学习目标

  • 安装 Tailwind CSS 与 PostCSS 插件
  • 在全局样式入口加载 Tailwind
  • 使用工具类构建响应式组件

安装并配置插件

如果项目创建时没有选择 Tailwind,在项目根目录执行安装命令。

bash
npm install --save-dev tailwindcss @tailwindcss/postcss postcss

预期输出:

text
added <COUNT> packages

<COUNT> 会随锁文件和已有依赖变化。安装完成后,在根目录创建 postcss.config.mjs。

js
const config = {
  plugins: {
    '@tailwindcss/postcss': {},
  },
}

export default config

生效行为:Next.js 构建 CSS 时会通过 PostCSS 调用 Tailwind 插件。重新启动开发服务器后,配置文件会被自动读取。

加载 Tailwind 样式

在根布局已经导入的 app/globals.css 中加入 Tailwind。项目原有的主题变量可以继续保留。

css
@import 'tailwindcss';

:root {
  --page-bg: #f7f8fc;
}

body {
  margin: 0;
  background: var(--page-bg);
}

验证方法:启动开发服务器后,在组件中添加 p-6 或 text-xl。如果页面间距和字号发生变化,说明工具类已经生成并加载。

构建并维护响应式组件

构建响应式课程卡片

Tailwind 默认采用移动优先方式。未带前缀的类作用于所有尺寸,md: 和 lg: 等前缀在对应宽度以上覆盖或追加规则。

tsx
export default function CourseCard() {
  return (
    <article className="grid gap-4 rounded-2xl bg-white p-5 shadow-sm md:grid-cols-[10rem_1fr] md:p-6">
      <div className="aspect-video rounded-xl bg-indigo-100 md:aspect-square" />
      <div className="flex flex-col justify-center">
        <p className="text-sm font-medium text-indigo-600">
          Next.js 基础
        </p>
        <h2 className="mt-1 text-xl font-bold text-slate-900 md:text-2xl">
          数据获取与缓存
        </h2>
        <p className="mt-2 text-sm leading-6 text-slate-600">
          学习服务端数据读取、缓存和按需刷新。
        </p>
        <button className="mt-4 w-full rounded-lg bg-indigo-600 px-4 py-2 font-semibold text-white md:w-fit">
          开始学习
        </button>
      </div>
    </article>
  )
}

预期结果:窄屏中卡片按单列排列,按钮占满可用宽度;达到 md 断点后,封面与文本变为两列,按钮宽度收缩为内容宽度。

保持类名可读

工具类较多时,应按布局、尺寸、颜色和状态形成稳定顺序。重复出现的复杂结构应抽成组件,而不是把同一长串类名复制到多个页面。

不要动态拼接不完整类名,例如 bg-${color}-600。构建工具难以可靠识别这类运行时字符串。应改用显式映射,把允许的业务值映射到完整类名。

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

目录与阅读设置

阅读设置

17

记录一个想法

集成 Tailwind CSS

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

登录哪都通