设计变量
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的colorprop 可单项覆盖。
文字色(浅色模式)
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-bg | rgba(0, 0, 0, 0.5) | 关闭等浮层控制按钮背景,明暗模式同值 |
--uikit-image-viewer-control-bg-hover | rgba(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-7 | 7px | 极小徽标数字(原 8px 档顺延) |
--uikit-font-size-9 | 9px | Overline、徽标数字 |
--uikit-font-size-11 | 11px | Caption、标签 |
--uikit-font-size-12 | 12px | Body-S、辅助说明 |
--uikit-font-size-13 | 13px | Body-M、默认正文 |
--uikit-font-size-14 | 14px | H4、单元格标题 |
--uikit-font-size-15 | 15px | Body-L、H3 |
--uikit-font-size-16 | 16px | H2、卡片标题 |
--uikit-font-size-18 | 18px | 弹窗标题 |
--uikit-font-size-20 | 20px | h2、页面标题 |
--uikit-font-size-22 | 22px | h1、模块大标题 |
--uikit-font-size-28 | 28px | h0、页面大标题 |
2026-09-18 起字号档位整体降一档:原 16px 档降为 15px,其余档位依次顺延(原 34px 最大档不再保留,新增 7px 最小档)。
字号 token 均乘以 --uikit-font-scale(默认 1),用于适老版全局放大。
字重与行高
| Token | 默认值 |
|---|---|
--uikit-font-weight-regular | 400 |
--uikit-font-weight-medium | 500 |
--uikit-font-weight-semibold | 600 |
--uikit-font-weight-bold | 700 |
--uikit-font-lineheight-tight | 1.25 |
--uikit-font-lineheight-normal | 1.5 |
--uikit-font-lineheight-relaxed | 1.75 |
完整排版层级表见 主题定制 - 排版层级。
间距
spacing-14px
spacing-28px
spacing-312px
spacing-416px
spacing-524px
spacing-632px
spacing-748px
圆角
| Token | 默认值 | 用途 |
|---|---|---|
--uikit-components-radius | 8px | 组件默认圆角 |
--uikit-components-radius-hover | 14px | hover / 展开态圆角 |
--uikit-image-viewer-control-radius | 50% | 图片预览浮层控制按钮圆形半径 |
--uikit-bubble-radius | 16px | 消息气泡圆角(round 档,默认) |
--uikit-bubble-radius-square | 8px | 消息气泡圆角(square 档) |
--uikit-input-radius | 999px | 输入框圆角(默认纯椭圆/胶囊,消息输入区消费) |
阴影
| Token | 默认值 |
|---|---|
--uikit-shadow-sm | 0 1px 2px rgba(0,0,0,0.04) |
--uikit-shadow | 0 6px 16px rgba(0,0,0,0.08), 0 12px 32px rgba(0,0,0,0.10) |
--uikit-shadow-hover | 0 10px 24px rgba(0,0,0,0.12), 0 18px 48px rgba(0,0,0,0.14) |
--uikit-input-focus-ring | 0 0 0 2px color-mix(in srgb, var(--uikit-primary-color) 20%, transparent)(消息输入卡片聚焦光环,跟随主色) |
动效
| Token | 默认值 | 用途 |
|---|---|---|
--uikit-anim-enabled | 1 | 全局动画开关(0 关闭) |
--uikit-anim-duration | 300ms | 基础时长 |
--uikit-anim-duration-enter | 350ms | 入场时长 |
--uikit-anim-duration-leave | 250ms | 出场时长 |
--uikit-anim-easing | cubic-bezier(0.4,0,0.2,1) | 标准缓动 |
--uikit-anim-easing-decel | cubic-bezier(0,0,0.2,1) | 入场减速 |
--uikit-anim-easing-accel | cubic-bezier(0.4,0,1,1) | 出场加速 |
--uikit-anim-easing-spring | cubic-bezier(0.34,1.56,0.64,1) | 弹性过冲 |
--uikit-anim-scale-press | 0.97 | 按压缩放比 |
--uikit-anim-scale-enter | 0.92 | 弹窗入场缩放起点 |
图标总览
线性图标(V2) (287)
archive (1)
archive点击复制arrow (13)
arrow/down点击复制arrow/down_line点击复制arrow/down_tray点击复制arrow/left点击复制arrow/lft_uturn点击复制arrow/rgt_uturn点击复制arrow/rgt_uturn_tray点击复制arrow/right点击复制arrow/turn_left点击复制arrow/turn_right点击复制arrow/up点击复制arrow/up_line点击复制arrow/up_tray点击复制at (1)
at点击复制bell (2)
bell点击复制bell/slash点击复制board (1)
board点击复制board-1 (1)
board-1点击复制bubble (8)
bubble/circle点击复制bubble/empty点击复制bubble/hashtag点击复制bubble/hora点击复制bubble/rect点击复制bubble/rect/2点击复制bubble/rect/empty点击复制bubble/slash点击复制camera (1)
camera点击复制check (2)
check/double点击复制check/single点击复制chevron (6)
chevron/down点击复制chevron/left-right点击复制chevron/left点击复制chevron/right点击复制chevron/up-down点击复制chevron/up点击复制circle (18)
circle/3bars点击复制circle/bang点击复制circle/candle点击复制circle/checked点击复制circle/clock点击复制circle/ellipsis点击复制circle/empty-1点击复制circle/empty点击复制circle/face点击复制circle/fill点击复制circle/img点击复制circle/minus点击复制circle/person点击复制circle/plus点击复制circle/quote点击复制circle/slash点击复制circle/waves点击复制circle/xmark点击复制console (1)
console点击复制crown (1)
crown点击复制dict (1)
dict点击复制doc (1)
doc点击复制dspntd (1)
dspntd点击复制envelope (1)
envelope点击复制envelope_2 (1)
envelope_2点击复制eye (2)
eye点击复制eye/slash点击复制file (12)
file点击复制file/archive点击复制file/audio点击复制file/doc点击复制file/empty点击复制file/img点击复制file/md点击复制file/pdf点击复制file/ppt点击复制file/video点击复制file/xls点击复制file/xmark点击复制filled (100)
filled/archive点击复制filled/at点击复制filled/bell点击复制filled/bell/slash点击复制filled/bubble/circle点击复制filled/bubble/empty点击复制filled/bubble/hora点击复制filled/bubble/rect点击复制filled/bubble/rect/empty点击复制filled/bubble/slash点击复制filled/camera点击复制filled/circle/bang点击复制filled/circle/candle点击复制filled/circle/checked点击复制filled/circle/clock点击复制filled/circle/ellipsis点击复制filled/circle/empty点击复制filled/circle/equals点击复制filled/circle/face点击复制filled/circle/img点击复制filled/circle/minus点击复制filled/circle/person点击复制filled/circle/plus点击复制filled/circle/quote点击复制filled/circle/slash点击复制filled/circle/star点击复制filled/circle/xmark点击复制filled/console点击复制filled/crown点击复制filled/doc点击复制filled/eye点击复制filled/eye/slash点击复制filled/file/audio点击复制filled/file/empty点击复制filled/file/img点击复制filled/file/pdf点击复制filled/file/ppt点击复制filled/file/video点击复制filled/file/xls点击复制filled/flower点击复制filled/folder点击复制filled/globe点击复制filled/loc点击复制filled/lock/closed点击复制filled/lock/dot点击复制filled/lock/open点击复制filled/mic点击复制filled/mic/slash点击复制filled/nut点击复制filled/person/check点击复制filled/person/double点击复制filled/person/list点击复制filled/person/minus点击复制filled/person/plus点击复制filled/person/single点击复制filled/person/xmark点击复制filled/phone点击复制filled/pin点击复制filled/pin/fill点击复制filled/pin/slash点击复制filled/plane点击复制filled/rect/candle点击复制filled/rect/checked点击复制filled/rect/empty点击复制filled/rect/fill-1点击复制filled/rect/fill点击复制filled/rect/hanzi点击复制filled/rect/hanzi/slash点击复制filled/rect/hanzinalpha点击复制filled/rect/hanzinalpha/slash点击复制filled/rect/idphoto点击复制filled/rect/img点击复制filled/rect/lftarrow点击复制filled/rect/minus-1点击复制filled/rect/minus点击复制filled/rect/pencil点击复制filled/rect/plane点击复制filled/rect/rgtarrow点击复制filled/rect/triangle点击复制filled/rect/xmark点击复制filled/rect_notched/pen点击复制filled/rects点击复制filled/search点击复制filled/search/minus点击复制filled/search/plus点击复制filled/search/xmark点击复制filled/shield点击复制filled/shield/checked点击复制filled/shield/person点击复制filled/shield/slash点击复制filled/shield/xmark点击复制filled/speaker/wave点击复制filled/speaker/wave_1点击复制filled/speaker/wave_2点击复制filled/speaker/xmark点击复制filled/trash点击复制filled/triangle点击复制filled/triangle/exclamation点击复制filled/video点击复制filled/video/slash点击复制flower (1)
flower点击复制folder (2)
folder点击复制folder/open点击复制globe (1)
globe点击复制hamburger (1)
hamburger点击复制horizontal (1)
horizontal点击复制items_check (1)
items_check点击复制knife (1)
knife点击复制lines (2)
lines点击复制lines/arrow-right_3bars点击复制list (2)
list点击复制list/bullet点击复制loading (4)
loading/2clrs点击复制loading/arc/big点击复制loading/arc/normal点击复制loading/arc/small点击复制loc (1)
loc点击复制lock (3)
lock/closed点击复制lock/dot点击复制lock/open点击复制mic (4)
mic点击复制mic/dot点击复制mic/fill点击复制mic/slash点击复制minus (1)
minus点击复制nut (1)
nut点击复制paperclip (1)
paperclip点击复制person (11)
person/arrows点击复制person/ban点击复制person/card点击复制person/check点击复制person/clock点击复制person/double点击复制person/list点击复制person/minus点击复制person/plus点击复制person/single点击复制person/xmark点击复制phone (1)
phone点击复制pin (3)
pin点击复制pin/fill点击复制pin/slash点击复制plane (1)
plane点击复制plus (1)
plus点击复制polyline (3)
polyline/singularity点击复制polyline/spread点击复制polyline/topright点击复制quote (4)
quote/left点击复制quote/left_down点击复制quote/right点击复制quote/right_down点击复制rect (26)
rect点击复制rect/3bars点击复制rect/candle点击复制rect/checked点击复制rect/equals点击复制rect/fill-1点击复制rect/fill点击复制rect/hanzi点击复制rect/hanzi/slash点击复制rect/hanzinalpha点击复制rect/hanzinalpha/slash点击复制rect/idphoto点击复制rect/img点击复制rect/keyboard点击复制rect/lftarrow点击复制rect/minus-1点击复制rect/minus点击复制rect/narrow-return点击复制rect/pencil点击复制rect/person-clock点击复制rect/plane点击复制rect/rgtarrow点击复制rect/star点击复制rect/triangle点击复制rect/waves点击复制rect/xmark点击复制rect_notched (1)
rect_notched/pen点击复制rects (1)
rects点击复制ringarrow (2)
ringarrow/ccw点击复制ringarrow/cw点击复制search (4)
search点击复制search/minus点击复制search/plus点击复制search/xmark点击复制shield (5)
shield点击复制shield/checked点击复制shield/person点击复制shield/slash点击复制shield/xmark点击复制signal (1)
signal点击复制speaker (4)
speaker/wave点击复制speaker/wave_1点击复制speaker/wave_2点击复制speaker/xmark点击复制status (5)
status/3pm点击复制status/check点击复制status/equals点击复制status/minus点击复制status/star点击复制trash (1)
trash点击复制triangle (2)
triangle点击复制triangle/exclamation点击复制unity (1)
unity点击复制vertical (1)
vertical点击复制video (2)
video点击复制video/slash点击复制voice_motion_01 (1)
voice_motion_01点击复制voice_motion_02 (1)
voice_motion_02点击复制voice_motion_03 (1)
voice_motion_03点击复制xmark (2)
xmark/bold点击复制xmark/light点击复制面性图标(Filled) (100)
filled (100)
filled/archive点击复制filled/at点击复制filled/bell点击复制filled/bell/slash点击复制filled/bubble/circle点击复制filled/bubble/empty点击复制filled/bubble/hora点击复制filled/bubble/rect点击复制filled/bubble/rect/empty点击复制filled/bubble/slash点击复制filled/camera点击复制filled/circle/bang点击复制filled/circle/candle点击复制filled/circle/checked点击复制filled/circle/clock点击复制filled/circle/ellipsis点击复制filled/circle/empty点击复制filled/circle/equals点击复制filled/circle/face点击复制filled/circle/img点击复制filled/circle/minus点击复制filled/circle/person点击复制filled/circle/plus点击复制filled/circle/quote点击复制filled/circle/slash点击复制filled/circle/star点击复制filled/circle/xmark点击复制filled/console点击复制filled/crown点击复制filled/doc点击复制filled/eye点击复制filled/eye/slash点击复制filled/file/audio点击复制filled/file/empty点击复制filled/file/img点击复制filled/file/pdf点击复制filled/file/ppt点击复制filled/file/video点击复制filled/file/xls点击复制filled/flower点击复制filled/folder点击复制filled/globe点击复制filled/loc点击复制filled/lock/closed点击复制filled/lock/dot点击复制filled/lock/open点击复制filled/mic点击复制filled/mic/slash点击复制filled/nut点击复制filled/person/check点击复制filled/person/double点击复制filled/person/list点击复制filled/person/minus点击复制filled/person/plus点击复制filled/person/single点击复制filled/person/xmark点击复制filled/phone点击复制filled/pin点击复制filled/pin/fill点击复制filled/pin/slash点击复制filled/plane点击复制filled/rect/candle点击复制filled/rect/checked点击复制filled/rect/empty点击复制filled/rect/fill-1点击复制filled/rect/fill点击复制filled/rect/hanzi点击复制filled/rect/hanzi/slash点击复制filled/rect/hanzinalpha点击复制filled/rect/hanzinalpha/slash点击复制filled/rect/idphoto点击复制filled/rect/img点击复制filled/rect/lftarrow点击复制filled/rect/minus-1点击复制filled/rect/minus点击复制filled/rect/pencil点击复制filled/rect/plane点击复制filled/rect/rgtarrow点击复制filled/rect/triangle点击复制filled/rect/xmark点击复制filled/rect_notched/pen点击复制filled/rects点击复制filled/search点击复制filled/search/minus点击复制filled/search/plus点击复制filled/search/xmark点击复制filled/shield点击复制filled/shield/checked点击复制filled/shield/person点击复制filled/shield/slash点击复制filled/shield/xmark点击复制filled/speaker/wave点击复制filled/speaker/wave_1点击复制filled/speaker/wave_2点击复制filled/speaker/xmark点击复制filled/trash点击复制filled/triangle点击复制filled/triangle/exclamation点击复制filled/video点击复制filled/video/slash点击复制