跳到正文
小佑Blog 站点标识小佑Bloglordblog.cn

最小组件库:11 个组件与 28 个 CSS 变量

工具与模板更新 2026-11-12组件库

11 个组件、28 个 CSS 变量、6.8KB 未压缩样式,压缩后 3.1KB。这套东西没有构建步骤,把两个文件丢进项目就能用,改主题只动 6 个变量。

这一期要解的问题

大组件库的问题不是不好用,是改不动。一个按钮组件背后可能有 40 个 props、3 层嵌套、一套主题系统,为了改一次圆角要读四份文档。小项目用不上这么多能力,却要背这套负担。

这一期做的是“够用就好”的一套:11 个组件覆盖按钮、输入、选择、开关、标签、卡片、提示、分页、面包屑、表格、空状态。所有可调项收敛成 28 个变量,颜色、圆角、间距、字号、阴影、动效各归一类。

十一个组件与变量分组

  • 组件 1—3 按钮、输入、选择:3 种尺寸、4 种状态、2 种风格
  • 组件 4—6 开关、标签、卡片:标签 5 种色调,卡片 2 种密度
  • 组件 7—9 提示、分页、面包屑:提示 3 类语义,分页最多 7 个页码
  • 组件 10 表格:宽表横滑、首列固定、斑马纹可关
  • 组件 11 空状态:图标位留空,用 CSS 画简单几何形
  • 变量组 1 颜色:主色、主色深、主色浅、正文、弱文本、线条、背景、警示
  • 变量组 2 尺寸:圆角 2 个、间距 6 个、字号 5 个、行高 3 个、阴影 2 个
/* 改主题只动这 6 个变量,其余 22 个由它们推导 */
:root {
  --xy-primary: #c2531a;
  --xy-ink: #201d1b;
  --xy-paper: #f6f3ee;
  --xy-line: #e6e0d7;
  --xy-radius: 6px;
  --xy-scale: 1;
}
.xy-btn {
  background: var(--xy-primary);
  border-radius: var(--xy-radius);
  padding: calc(8px * var(--xy-scale)) calc(16px * var(--xy-scale));
}

参数与交付

项目内容
难度偏低,会写 CSS 即可
章节6 章,含 11 个组件的完整样式与 1 份变量表
实测时长5 小时(读 3 小时 + 接入 2 小时)
验证环境Chrome 142 / Safari 26.0 / Firefox 145
前置知识知道自定义属性的继承规则
配套资源2 个样式文件、1 个演示页、变量对照表
更新节奏每半年补一次新组件
阅读授权单账号,可读 24 个月,可商用

三个会用到它的场合

后台系统的第一版界面

后台系统不需要品牌感,需要的是稳定与一致。11 个组件接上之后,一个列表页的样式工作量从 2 天压到 4 小时,剩下的时间花在业务逻辑上。

外包交付要给客户改主题

客户常要求换成自己的主色。28 个变量里有 6 个是主题开关,其余由它们推导,换色只需改 6 行,不会出现某个按钮还是旧颜色。

邮件模板或简单落地页

这类页面不能引入 JS 框架。纯 CSS 组件可以直接内联进 HTML,6.8KB 的样式对邮件客户端来说也在可接受范围。

和常见讲法差在哪

  • 只有 28 个变量,每一个都写明了推导关系。大组件库的变量动辄 200 个,改一次主题要读半天文档。
  • 没有构建步骤。两个文件、一次 link 引入,不需要 PostCSS 或任何编译,交付给任何人都能直接跑。
  • 11 个组件的取舍写清楚了:为什么不做模态框、不做下拉树、不做日期选择器,理由与替代方案都在第 6 章。

交付周期与阅读节奏

开通 10 分钟内可读,样式文件随页面下载。6 章建议一天读完,第 1—2 章看变量与推导,第 3—5 章按项目需要的组件读,第 6 章看取舍与扩展。中位耗时 5 小时,接入 2 小时左右。

服务条款

14 天内可退。样式文件可商用,可修改,无需署名;不得原样作为独立商品转售。若某个组件在你的目标浏览器里表现异常,可在附件页留言,15 个工作日内给修复样式。

选型建议

如果你的项目已经有成熟组件库,别换,迁移成本高于收益。适合的是三种:从零起步的内部系统、需要交付源码给客户的项目、以及样式总量不到 2000 行的轻量站点。第二种最合适,客户拿到的是可读的 CSS 而不是一堆构建产物。

读完常见的问题

支持暗色主题吗?
支持。第 5 章给了 6 个变量的暗色取值,切换只需在根节点加一个类名,不用另写一套样式。
能和 Tailwind 一起用吗?
可以,但没必要。两套间距体系会打架,文中说明了如何只保留 Tailwind 的布局工具类。
为什么不做模态框?
模态框涉及焦点管理与滚动锁定,纯 CSS 做不干净。第 6 章推荐用原生 dialog 元素,附了 30 行样式。

同方向的其他两期