HTML / CSS / 系统课时
提取重复样式组合
提取重复样式组合
复制同一串 Tailwind CSS 类名可以快速完成第一个界面,但继续复制会让间距、状态和无障碍行为逐渐分叉。本课从复用价值出发,把重复卡片提取为语义清晰的 React 组件,并说明哪些变化应保留为属性,哪些样式不值得过早抽象。
学习目标
- 判断重复代码是否已经形成稳定的组件语义。
- 把稳定结构、默认样式、可变内容和状态分支分别建模。
- 避免仅为缩短类名而制造难理解的公共抽象。
先判断重复是否值得提取
真正值得提取的重复通常同时满足三个条件:结构在多个位置一致、变化点可以用少量属性表达、修改时需要同步更新。若两段代码只是偶然拥有相似颜色,却承担不同业务含义,强行合并会让后续改动互相牵制。
提取目标也不一定是 CSS。重复数据适合用数组和 map 渲染,重复结构适合组件,跨框架或第三方节点上的少量公共规则才考虑 @apply。Tailwind 项目中,优先保留完整语义组件,而不是创建一个只替代长类名的模糊名称。
从重复代码识别稳定边界

提取时先圈定不会变化的部分,例如卡片容器、标题层级、按钮位置和焦点样式;再列出允许变化的内容,例如标题、说明和发布状态。组件属性只描述这些业务差异,不要把 rounded-xl、px-5 之类内部实现暴露为业务参数。
主示例:提取 CourseCard
下面是片段示例,依赖一个已经配置 Tailwind CSS 的 React 与 TypeScript 项目。把代码放入 App.tsx 后启动现有开发服务器,即可验证抽象后的结构和状态是否一致。
import React from 'react';
type Status = 'draft' | 'published';
type CourseCardProps = {
title: string;
description: string;
status: Status;
onOpen: () => void;
};
const statusStyles: Record<Status, string> = {
draft: 'bg-amber-50 text-amber-700 ring-amber-200',
published: 'bg-emerald-50 text-emerald-700 ring-emerald-200',
};
const statusLabels: Record<Status, string> = {
draft: '草稿',
published: '已发布',
};
function CourseCard({
title,
description,
status,
onOpen,
}: CourseCardProps) {
return (
<article className="rounded-xl border border-slate-200 bg-white p-5 shadow-sm">
<div className="flex items-start justify-between gap-4">
<div>
<h2 className="text-lg font-semibold text-slate-900">{title}</h2>
<p className="mt-2 text-sm leading-6 text-slate-600">
{description}
</p>
</div>
<span
className={`inline-flex rounded-full px-2 py-1 text-xs font-medium ring-1 ${statusStyles[status]}`}
>
{statusLabels[status]}
</span>
</div>
<button
type="button"
onClick={onOpen}
className="mt-4 rounded-md bg-sky-600 px-3 py-2 text-sm font-medium text-white hover:bg-sky-700 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-sky-500"
>
查看课程
</button>
</article>
);
}
const courses: Array<Omit<CourseCardProps, 'onOpen'>> = [
{
title: 'Tailwind CSS 基础',
description: '掌握工具类、响应式设计与组件抽象。',
status: 'published',
},
{
title: '组件设计练习',
description: '把重复界面提取为稳定、可复用的组件。',
status: 'draft',
},
];
export default function App() {
return (
<main className="grid gap-4 p-6 md:grid-cols-2">
{courses.map((course) => (
<CourseCard
key={course.title}
{...course}
onOpen={() => window.alert(course.title)}
/>
))}
</main>
);
}预期结果
移动端显示两张单列课程卡片,md 断点及以上显示两列。
两张卡片共享相同的边框、间距、按钮与焦点样式。
“已发布”使用绿色状态标签,“草稿”使用琥珀色状态标签。这个组件把稳定结构和默认样式封装在内部,把标题、说明、状态和点击行为保留为属性。以后修改卡片内边距或按钮焦点样式时,只需更新 CourseCard,所有使用位置会同步生效。
避免过度抽象
不要因为两处都出现 flex items-center 就立即创建公共类。只有当这组样式拥有稳定语义,并且变化应当一起发生时,抽象才会降低维护成本。否则,一个名为 common-row 的类会隐藏真实布局意图,还可能把无关页面绑定在一起。
同样不要为每个视觉细节增加属性,例如 rounded、shadow、padding。属性数量持续增加通常说明组件边界过宽,应拆分组件或提供少量明确变体,例如 status、size、emphasis,而不是暴露所有 Tailwind 工具类。
验收提取是否成功
完成抽象后,应从三个方向检查:修改默认样式是否只需改一处;新增同类卡片是否只需提供数据;不同状态是否通过受控属性表达。若调用方仍需要复制大量内部类名,或为了一个例外传入十几个参数,说明边界仍需调整。
还要确认组件没有破坏语义标签、键盘焦点和响应式布局。复用的目标不是单纯减少字符,而是让结构、交互和视觉规则保持一致,同时保留真正需要变化的业务信息。