HTML / CSS / 系统课时

提取重复样式组合

提取重复样式组合

复制同一串 Tailwind CSS 类名可以快速完成第一个界面,但继续复制会让间距、状态和无障碍行为逐渐分叉。本课从复用价值出发,把重复卡片提取为语义清晰的 React 组件,并说明哪些变化应保留为属性,哪些样式不值得过早抽象。

学习目标

  • 判断重复代码是否已经形成稳定的组件语义。
  • 把稳定结构、默认样式、可变内容和状态分支分别建模。
  • 避免仅为缩短类名而制造难理解的公共抽象。

先判断重复是否值得提取

真正值得提取的重复通常同时满足三个条件:结构在多个位置一致、变化点可以用少量属性表达、修改时需要同步更新。若两段代码只是偶然拥有相似颜色,却承担不同业务含义,强行合并会让后续改动互相牵制。

提取目标也不一定是 CSS。重复数据适合用数组和 map 渲染,重复结构适合组件,跨框架或第三方节点上的少量公共规则才考虑 @apply。Tailwind 项目中,优先保留完整语义组件,而不是创建一个只替代长类名的模糊名称。

从重复代码识别稳定边界

重复课程卡片到组件抽象的关系

提取时先圈定不会变化的部分,例如卡片容器、标题层级、按钮位置和焦点样式;再列出允许变化的内容,例如标题、说明和发布状态。组件属性只描述这些业务差异,不要把 rounded-xl、px-5 之类内部实现暴露为业务参数。

主示例:提取 CourseCard

下面是片段示例,依赖一个已经配置 Tailwind CSS 的 React 与 TypeScript 项目。把代码放入 App.tsx 后启动现有开发服务器,即可验证抽象后的结构和状态是否一致。

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>
  );
}

预期结果

text
移动端显示两张单列课程卡片,md 断点及以上显示两列。
两张卡片共享相同的边框、间距、按钮与焦点样式。
“已发布”使用绿色状态标签,“草稿”使用琥珀色状态标签。

这个组件把稳定结构和默认样式封装在内部,把标题、说明、状态和点击行为保留为属性。以后修改卡片内边距或按钮焦点样式时,只需更新 CourseCard,所有使用位置会同步生效。

避免过度抽象

不要因为两处都出现 flex items-center 就立即创建公共类。只有当这组样式拥有稳定语义,并且变化应当一起发生时,抽象才会降低维护成本。否则,一个名为 common-row 的类会隐藏真实布局意图,还可能把无关页面绑定在一起。

同样不要为每个视觉细节增加属性,例如 rounded、shadow、padding。属性数量持续增加通常说明组件边界过宽,应拆分组件或提供少量明确变体,例如 status、size、emphasis,而不是暴露所有 Tailwind 工具类。

验收提取是否成功

完成抽象后,应从三个方向检查:修改默认样式是否只需改一处;新增同类卡片是否只需提供数据;不同状态是否通过受控属性表达。若调用方仍需要复制大量内部类名,或为了一个例外传入十几个参数,说明边界仍需调整。

还要确认组件没有破坏语义标签、键盘焦点和响应式布局。复用的目标不是单纯减少字符,而是让结构、交互和视觉规则保持一致,同时保留真正需要变化的业务信息。

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

目录与阅读设置

阅读设置

17

记录一个想法

提取重复样式组合

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

登录哪都通