跳到正文

设计变量 ​

UIKit 所有视觉参数沉淀为 --uikit-* CSS 变量,按颜色、字号、间距、圆角、阴影、动效六大类管理。本页集中展示全部 token 默认值与用途,便于设计与开发对齐。

颜色 ​

品牌色与语义色 ​

primary-colorhsl(203, 100%, 60%)
success-colorhsl(142, 76%, 36%)
warning-colorhsl(38, 100%, 60%)
danger-colorhsl(350, 100%, 60%)
info-colorhsl(203, 100%, 60%)
badge-bg#FF7070

--uikit-badge-bg(core 2.3.0):徽标(未读数 / 红点)默认背景色,独立于 danger 语义色,明暗模式同值;Badge 的 color prop 可单项覆盖。

文字色(浅色模式) ​

text-primary#171A1C
text-secondary#5E686E
text-tertiary#919BA1
text-inverse#ffffff

背景色(浅色模式) ​

bg-base#ffffff
bg-secondary#f3f4f6
bg-tertiary#f0f0f0
bg-elevated#ffffff
bg-hover#F5F5F5
conversation-list-bg#FAFAFA

暗色模式对应值见 主题定制 页暗色段,所有颜色 token 均已在 [data-uikit-theme="dark"] 下重写。

图片预览控制按钮 ​

Token默认值用途
--uikit-image-viewer-control-bgrgba(0, 0, 0, 0.5)关闭等浮层控制按钮背景,明暗模式同值
--uikit-image-viewer-control-bg-hoverrgba(0, 0, 0, 0.7)浮层控制按钮 hover 背景,明暗模式同值

文件消息图标底色(core 2.6.0) ​

文件消息气泡左侧固定展示彩色底色块(双方气泡一致),图标本体固定白色,底色按扩展名 / 类别取对应品牌识别色,明暗模式通用:

file-icon-pdf#DA3034
file-icon-xls#1D7044
file-icon-doc#2B5797
file-icon-ppt#D24625
file-icon-md#424242
file-icon-img#00897B
file-icon-video#E91E63
file-icon-audio#7B1FA2
file-icon-file#4CAF50

上表 token 全名带 --uikit- 前缀(如 --uikit-file-icon-pdf);file-icon-file 为未识别类型的普通文件回落色。

字号 ​

Token默认值用途
--uikit-font-size-77px极小徽标数字(原 8px 档顺延)
--uikit-font-size-99pxOverline、徽标数字
--uikit-font-size-1111pxCaption、标签
--uikit-font-size-1212pxBody-S、辅助说明
--uikit-font-size-1313pxBody-M、默认正文
--uikit-font-size-1414pxH4、单元格标题
--uikit-font-size-1515pxBody-L、H3
--uikit-font-size-1616pxH2、卡片标题
--uikit-font-size-1818px弹窗标题
--uikit-font-size-2020pxh2、页面标题
--uikit-font-size-2222pxh1、模块大标题
--uikit-font-size-2828pxh0、页面大标题

2026-09-18 起字号档位整体降一档:原 16px 档降为 15px,其余档位依次顺延(原 34px 最大档不再保留,新增 7px 最小档)。

字号 token 均乘以 --uikit-font-scale(默认 1),用于适老版全局放大。

字重与行高 ​

Token默认值
--uikit-font-weight-regular400
--uikit-font-weight-medium500
--uikit-font-weight-semibold600
--uikit-font-weight-bold700
--uikit-font-lineheight-tight1.25
--uikit-font-lineheight-normal1.5
--uikit-font-lineheight-relaxed1.75

完整排版层级表见 主题定制 - 排版层级。

间距 ​

spacing-14px
spacing-28px
spacing-312px
spacing-416px
spacing-524px
spacing-632px
spacing-748px

圆角 ​

Token默认值用途
--uikit-components-radius8px组件默认圆角
--uikit-components-radius-hover14pxhover / 展开态圆角
--uikit-image-viewer-control-radius50%图片预览浮层控制按钮圆形半径
--uikit-bubble-radius16px消息气泡圆角(round 档,默认)
--uikit-bubble-radius-square8px消息气泡圆角(square 档)
--uikit-input-radius999px输入框圆角(默认纯椭圆/胶囊,消息输入区消费)

阴影 ​

Token默认值
--uikit-shadow-sm0 1px 2px rgba(0,0,0,0.04)
--uikit-shadow0 6px 16px rgba(0,0,0,0.08), 0 12px 32px rgba(0,0,0,0.10)
--uikit-shadow-hover0 10px 24px rgba(0,0,0,0.12), 0 18px 48px rgba(0,0,0,0.14)
--uikit-input-focus-ring0 0 0 2px color-mix(in srgb, var(--uikit-primary-color) 20%, transparent)(消息输入卡片聚焦光环,跟随主色)

动效 ​

Token默认值用途
--uikit-anim-enabled1全局动画开关(0 关闭)
--uikit-anim-duration300ms基础时长
--uikit-anim-duration-enter350ms入场时长
--uikit-anim-duration-leave250ms出场时长
--uikit-anim-easingcubic-bezier(0.4,0,0.2,1)标准缓动
--uikit-anim-easing-decelcubic-bezier(0,0,0.2,1)入场减速
--uikit-anim-easing-accelcubic-bezier(0.4,0,1,1)出场加速
--uikit-anim-easing-springcubic-bezier(0.34,1.56,0.64,1)弹性过冲
--uikit-anim-scale-press0.97按压缩放比
--uikit-anim-scale-enter0.92弹窗入场缩放起点

图标总览 ​