组件库
两套基于 Base UI 的 React 组件库:温暖友好的 Ink UI,与 Figma UI3 风格的 FigUI。
- 2025.07.12 – 至今
- 独立设计与开发
我独立设计并开发了两套基于 Base UI 的 React 组件库。均是由其他项目转化而来。
Ink UI
Ink UI 最初是 Flowingto 的内部组件库,后经抽离并开源,使用 Tailwind CSS v4 编写样式,见 ink-ui.com。
整体设计以温暖与友好为方向:以暖灰色和橙色为主要配色,并广泛使用较大的圆角,旨在营造更具亲和力的界面。因此,相较于信息密集的后台与仪表盘,它更适用于面向普通用户的消费级产品。
颜色
Ink UI 未直接采用 Tailwind 默认的 stone 色板,而是手动调整了灰色,使其仅比中性灰略暖,接近纸张的色调。主色橙色与辅助色红色同样经过手动选取,饱和度低于 Tailwind 的同名颜色。所有颜色均在 OKLCH 色彩空间中扩展为色阶,以保证一致的视觉感受。
gray
orange
red
状态
shadcn/ui 主要通过在基础色上叠加透明度来表达组件状态,例如 hover:bg-primary/90。这种方式存在两项限制:叠加所得的颜色只能朝单一方向变化,无法实现浅色模式下 hover 加深、深色模式下 hover 变浅;hover 与 active 也无法分别定义独立的语义色。Ink UI 在 shadcn/ui 的主题之上,为各 surface color 的不同状态补充了独立的 token,使每个状态的颜色均可精确控制,覆盖了设计系统中的绝大多数交互场景。
--background
--card
--primary
--secondary
--accent
--destructive
这些状态色由基础色通过 color-mix 向 --foreground 混合得到,因此同一公式在浅色模式下使 hover 加深,在深色模式下使 hover 变浅,切换主题即可观察到差异。secondary 为例外:它本身是叠加于背景之上的半透明色,其 hover 与 active 状态通过提高不透明度实现。
动效与细节
动效系统强调流畅、自然的过渡,以克制的微交互提升界面的精致程度,同时避免分散用户对内容的注意力。具体包括:
- button 进入 loading 状态时的过渡;
- menu 中仅有一项带图标时,各项文字自动对齐;
- menu 与 select 的 trigger 在面板展开期间保持 hover 状态;
- 滚动条在顶部与右侧均保留间距。
FigUI
FigUI 衍生自 Annotation Toolkit 的开发过程,见 figui.dev。为使插件保持与 Figma 原生一致的使用体验,我比较了现有的插件组件库,均未能满足需求:部分仍沿用 UI2 的样式,部分以 Web Component 而非 React 组件实现。
设计变量
Ink UI 的颜色需要逐一调整,FigUI 的颜色则不应调整。FigUI 的颜色、圆角、阴影与字体均直接取自 Figma 网页端的样式。圆角为 2px、5px、13px 三档,正文为 11px、字重 450 的 Inter。Figma 在网页端使用的是语义 token,而我希望完全以 Tailwind 的方式复刻组件,因此借助 AI 将其转写为 Tailwind 的原子 token,灰色、蓝色等色阶均保留原值。既然目标是完全复刻,Tailwind 的默认颜色也就没有保留的理由,我在主题中将其全部清空,组件中只能使用 Figma 的色阶。
输入控件
通用组件库很少包含 Figma 属性面板中的输入方式,而这些恰恰是插件界面最常用的部分。FigUI 因此补充了几类 Figma 特有的控件:在 X、Y 等标签上左右拖动即可调整数值的数字输入框,由色块、十六进制色值与不透明度组成的颜色输入框,以及把多个输入框合并为一行的输入组。数字拖动基于 Base UI NumberField 的 ScrubArea 实现,拖动期间输入框显示蓝色描边,光标替换为左右箭头,与 Figma 的行为保持一致。
以 FigUI 搭建的插件面板,左为浅色主题,右为深色主题。位置、高度与填充三行均为 Figma 特有的输入控件
现状
29
Ink UI 组件
16
FigUI 组件
59
GitHub star 合计
两套组件库均已开源。Ink UI 主要作为我个人项目的组件库,除 Flowingto 外亦用于其他项目。FigUI 用于 Annotation Toolkit,并已被收录于 Base UI 的社区页面。