鑫EN

组件库

两套基于 Base UI 的 React 组件库:温暖友好的 Ink UI,与 Figma UI3 风格的 FigUI。

时间
2025.07.12 – 至今
角色
独立设计与开发

我独立设计并开发了两套基于 Base UI 的 React 组件库。均是由其他项目转化而来。

同一个面板,左为 Ink UI,右为 FigUI。

Ink UI

Ink UI 最初是 Flowingto 的内部组件库,后经抽离并开源,使用 Tailwind CSS v4 编写样式,见 ink-ui.com。

整体设计以温暖与友好为方向:以暖灰色和橙色为主要配色,并广泛使用较大的圆角,旨在营造更具亲和力的界面。因此,相较于信息密集的后台与仪表盘,它更适用于面向普通用户的消费级产品。

颜色

Ink UI 未直接采用 Tailwind 默认的 stone 色板,而是手动调整了灰色,使其仅比中性灰略暖,接近纸张的色调。主色橙色与辅助色红色同样经过手动选取,饱和度低于 Tailwind 的同名颜色。所有颜色均在 OKLCH 色彩空间中扩展为色阶,以保证一致的视觉感受。

gray

50
100
200
300
400
500
600
700
800
900
950

orange

50
100
200
300
400
500
600
700
800
900
950

red

50
100
200
300
400
500
600
700
800
900
950

状态

shadcn/ui 主要通过在基础色上叠加透明度来表达组件状态,例如 hover:bg-primary/90。这种方式存在两项限制:叠加所得的颜色只能朝单一方向变化,无法实现浅色模式下 hover 加深、深色模式下 hover 变浅;hover 与 active 也无法分别定义独立的语义色。Ink UI 在 shadcn/ui 的主题之上,为各 surface color 的不同状态补充了独立的 token,使每个状态的颜色均可精确控制,覆盖了设计系统中的绝大多数交互场景。

--background

base
hover
active

--card

base
hover
active

--primary

base
hover
active

--secondary

base
hover
active

--accent

base
hover
active

--destructive

base
hover
active

这些状态色由基础色通过 color-mix 向 --foreground 混合得到,因此同一公式在浅色模式下使 hover 加深,在深色模式下使 hover 变浅,切换主题即可观察到差异。secondary 为例外:它本身是叠加于背景之上的半透明色,其 hover 与 active 状态通过提高不透明度实现。

动效与细节

动效系统强调流畅、自然的过渡,以克制的微交互提升界面的精致程度,同时避免分散用户对内容的注意力。具体包括:

  • button 进入 loading 状态时的过渡;
  • menu 中仅有一项带图标时,各项文字自动对齐;
  • menu 与 select 的 trigger 在面板展开期间保持 hover 状态;
  • 滚动条在顶部与右侧均保留间距。
重播
重播
重播
Ink UI 组件动效

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 的社区页面。