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。构建工具难以可靠识别这类运行时字符串。应改用显式映射,把允许的业务值映射到完整类名。
按自己的节奏,确认真正理解。