最小组件库:11 个组件与 28 个 CSS 变量
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 行样式。