Skip to content

Semantic Token ​

每个 Token 都表达用途,而不是某个固定颜色。切换 Latte / Macchiato 时,业务 utility 不变。

使用规则 ​

  • 页面、容器和浮层分别使用 background、surface、surface-elevated,层级同时依赖 tone、border 与 shadow。
  • primary 是最高优先级行为;accent 只负责 hover、selection 和轻量选中。
  • ring 专用于 focus-visible,不与 primary 强制相等。
  • error 是颜色语义,组件层的 destructive 行为映射到它。
  • tip 是无状态的建议;有明确系统状态时使用 info。

完整规范 ​

下表由 packages/ui 直接渲染,因此文档值与发布包不会漂移。实心背景与 foreground pairing 需达到 WCAG AA;subtle 组合按正文场景检查。

49 / 49
Token语义 / 使用边界ForegroundLatteMacchiatoUnoCSS
background
页面最底层画布。应用和完整页面背景。避免:不要用来模拟悬浮层。foreground
#eff1f5
oklch(0.9578 0.0058 264.53)
#181926
oklch(0.2188 0.0255 280.66)
bg-backgroundvar(--pd-color-background)
foreground
页面默认文字和图标。正文及高优先级内容。避免:不要用于彩色实心背景。—
#4c4f69
oklch(0.4355 0.0430 279.33)
#cad3f5
oklch(0.8708 0.0481 273.67)
text-foregroundvar(--pd-color-foreground)
surface
普通区域容器。侧栏、面板和分组区域。避免:不要替代页面背景。surface-foreground
#e6e9ef
oklch(0.9335 0.0087 264.52)
#1e2030
oklch(0.2493 0.0305 278.44)
bg-surfacevar(--pd-color-surface)
surface-foreground
区域容器内的默认文字。侧栏与面板的正文和标题。避免:不要用于容器之外的页面级文字。—
#4c4f69
oklch(0.4355 0.0430 279.33)
#cad3f5
oklch(0.8708 0.0481 273.67)
text-surface-foregroundvar(--pd-color-surface-foreground)
surface-subtle
弱化的次级表面。表头、分组和禁用区域。避免:不要承载最高优先级操作。—
#dce0e8
oklch(0.9060 0.0117 264.51)
#24273a
oklch(0.2788 0.0353 276.94)
bg-surface-subtlevar(--pd-color-surface-subtle)
surface-elevated
视觉层级更高的表面。菜单、对话框和浮层。避免:不要仅靠阴影表达层级。—
#ffffff
oklch(1.0000 0.0000 89.88)
#363a4f
oklch(0.3538 0.0369 275.99)
bg-surface-elevatedvar(--pd-color-surface-elevated)
card
承载一组内容的卡片表面。指标卡、列表项和表单分组。避免:不要在卡片内再嵌套同级卡片。card-foreground
#ffffff
oklch(1.0000 0.0000 89.88)
#24273a
oklch(0.2788 0.0353 276.94)
bg-cardvar(--pd-color-card)
card-foreground
卡片表面上的默认文字。卡片标题与正文。避免:不要用在卡片之外的表面。—
#4c4f69
oklch(0.4355 0.0430 279.33)
#cad3f5
oklch(0.8708 0.0481 273.67)
text-card-foregroundvar(--pd-color-card-foreground)
popover
脱离文档流的浮层表面。菜单、下拉、Tooltip 与对话框。避免:不要用于静态布局分块。popover-foreground
#ffffff
oklch(1.0000 0.0000 89.88)
#363a4f
oklch(0.3538 0.0369 275.99)
bg-popovervar(--pd-color-popover)
popover-foreground
浮层内的默认文字。菜单项、命令面板与对话框文本。避免:不要用于页面内联内容。—
#4c4f69
oklch(0.4355 0.0430 279.33)
#cad3f5
oklch(0.8708 0.0481 273.67)
text-popover-foregroundvar(--pd-color-popover-foreground)
primary
最高优先级行为和品牌表达。主按钮、关键选中态。避免:不要铺满大面积背景。primary-foreground
#006b67
oklch(0.4763 0.0822 190.27)
#69c7bd
oklch(0.7691 0.0910 186.47)
bg-primaryvar(--pd-color-primary)
primary-foreground
primary 实心背景上的文字与图标。主按钮标签和 primary 徽标。避免:不要当作独立文字色用在浅色背景上。—
#ffffff
oklch(1.0000 0.0000 89.88)
#181926
oklch(0.2188 0.0255 280.66)
text-primary-foregroundvar(--pd-color-primary-foreground)
primary-strong
primary 的加深变体。主按钮 hover 与 pressed 态。避免:不要与 primary 并列为两个品牌色。—
#005450
oklch(0.4021 0.0696 189.22)
#8bd5ca
oklch(0.8214 0.0755 184.10)
bg-primary-strongvar(--pd-color-primary-strong)
secondary
次级交互表面。次按钮和弱选中态。避免:不要与 primary 竞争。secondary-foreground
#e2e7f0
oklch(0.9268 0.0133 262.38)
#363a4f
oklch(0.3538 0.0369 275.99)
bg-secondaryvar(--pd-color-secondary)
secondary-foreground
次级交互表面上的文字。次按钮标签与弱选中态文字。避免:不要用于主操作。—
#414559
oklch(0.3949 0.0342 275.90)
#cad3f5
oklch(0.8708 0.0481 273.67)
text-secondary-foregroundvar(--pd-color-secondary-foreground)
accent
短暂或轻量强调。hover、selection、active。避免:不等同于品牌主色。accent-foreground
#d8dce7
oklch(0.8947 0.0156 269.97)
#41455c
oklch(0.3963 0.0392 276.79)
bg-accentvar(--pd-color-accent)
accent-foreground
accent 背景上的文字。hover 行与选中行的文字。避免:不要替代 foreground 承担正文。—
#4c4f69
oklch(0.4355 0.0430 279.33)
#cad3f5
oklch(0.8708 0.0481 273.67)
text-accent-foregroundvar(--pd-color-accent-foreground)
muted
弱内容背景。占位、禁用和辅助区域。避免:不要用于关键状态。muted-foreground
#e6e9ef
oklch(0.9335 0.0087 264.52)
#24273a
oklch(0.2788 0.0353 276.94)
bg-mutedvar(--pd-color-muted)
muted-foreground
弱化的辅助文字。说明、时间戳和次要元信息。避免:不要承载正文主体内容。—
#5c5f77
oklch(0.4920 0.0385 279.30)
#a5adcb
oklch(0.7513 0.0441 273.53)
text-muted-foregroundvar(--pd-color-muted-foreground)
border
默认结构边界。卡片、分隔和控件边缘。避免:不要承担焦点指示。—
#bcc0cc
oklch(0.8083 0.0174 271.20)
#494d64
oklch(0.4259 0.0385 276.95)
border-bordervar(--pd-color-border)
border-muted
最弱的分隔边界。表格行与列表项之间的浅分隔。避免:不要用于控件轮廓。—
#dce0e8
oklch(0.9060 0.0117 264.51)
#363a4f
oklch(0.3538 0.0369 275.99)
border-border-mutedvar(--pd-color-border-muted)
border-strong
加强的结构边界。需要明确分界的容器与分隔线。避免:不要用于文字或图标。—
#9ca0b0
oklch(0.7077 0.0237 274.60)
#6e738d
oklch(0.5608 0.0407 276.47)
border-border-strongvar(--pd-color-border-strong)
input
输入控件边界。表单控件静止态。避免:不要用于 focus ring。—
#c6cad4
oklch(0.8389 0.0146 268.47)
#5b6078
oklch(0.4939 0.0389 275.68)
border-inputvar(--pd-color-input)
ring
键盘焦点指示。focus-visible 外环。避免:不要用 hover 代替。—
#008080
oklch(0.5431 0.0927 194.77)
#8bd5ca
oklch(0.8214 0.0755 184.10)
ring-ringvar(--pd-color-ring)
info
明确的信息状态。同步、运行、版本提示。避免:不要用于普通技巧。info-foreground
#1e66f5
oklch(0.5586 0.2255 262.09)
#8aadf4
oklch(0.7497 0.1101 263.81)
bg-infovar(--pd-color-info)
info-foreground
info 实心背景上的文字。实心信息徽标与提示条文字。避免:不要当作文字色用在浅色背景上。—
#ffffff
oklch(1.0000 0.0000 89.88)
#18203b
oklch(0.2510 0.0525 269.85)
text-info-foregroundvar(--pd-color-info-foreground)
info-subtle
info 的浅色背景。信息提示条与状态标签底色。避免:不要用于大面积页面背景。info-subtle-foreground
#dce8ff
oklch(0.9290 0.0338 263.58)
#293a58
oklch(0.3484 0.0573 261.28)
bg-info-subtlevar(--pd-color-info-subtle)
info-subtle-foreground
info 浅色背景上的文字。提示条正文与状态标签文字。避免:不要与 info 实心色互换使用。—
#17407f
oklch(0.3808 0.1161 259.05)
#b8d4ff
oklch(0.8638 0.0672 258.87)
text-info-subtle-foregroundvar(--pd-color-info-subtle-foreground)
info-border
info 状态区域的边界。提示条与状态卡片的描边。避免:不要用于普通结构边界。—
#8eb2fa
oklch(0.7653 0.1113 263.59)
#5276a8
oklch(0.5604 0.0884 256.75)
border-info-bordervar(--pd-color-info-border)
warning
需要注意、仍可继续的状态,作为实心背景使用。实心警告按钮、徽标与 Toast 底色。避免:不要当作浅色背景上的文字色——文字请用 warning-subtle-foreground。warning-foreground
#f0b429
oklch(0.8045 0.1558 82.54)
#eed49f
oklch(0.8790 0.0744 84.75)
bg-warningvar(--pd-color-warning)
warning-foreground
warning 实心背景上的文字,用深色以承载浅琥珀底。实心警告按钮、徽标与 Toast 的文字。避免:不要用在 warning 之外的其他背景上。—
#5c3d00
oklch(0.3860 0.0809 76.57)
#3a2c16
oklch(0.3033 0.0406 77.58)
text-warning-foregroundvar(--pd-color-warning-foreground)
warning-subtle
warning 的浅色背景。风险提示条与待复核标签底色。避免:不要用于已失败状态。warning-subtle-foreground
#fff0d1
oklch(0.9591 0.0436 85.24)
#4a3c28
oklch(0.3655 0.0373 76.02)
bg-warning-subtlevar(--pd-color-warning-subtle)
warning-subtle-foreground
warning 浅色背景上的文字。风险提示正文。避免:不要表达错误结论。—
#8a5600
oklch(0.4999 0.1085 69.63)
#ffe2a8
oklch(0.9232 0.0806 84.32)
text-warning-subtle-foregroundvar(--pd-color-warning-subtle-foreground)
warning-border
warning 状态区域的边界。风险提示条与待复核卡片描边。避免:不要用于普通结构边界。—
#dfa94f
oklch(0.7681 0.1240 77.77)
#7c6841
oklch(0.5271 0.0609 83.32)
border-warning-bordervar(--pd-color-warning-border)
error
错误和失败的颜色语义。校验失败和危险结果。避免:destructive 应在组件层映射到它。error-foreground
#bc2446
oklch(0.5222 0.1857 14.83)
#ed8796
oklch(0.7370 0.1252 11.19)
bg-errorvar(--pd-color-error)
error-foreground
error 实心背景上的文字。实心错误徽标与危险按钮标签。避免:不要当作文字色用在浅色背景上。—
#ffffff
oklch(1.0000 0.0000 89.88)
#3b1821
oklch(0.2640 0.0562 5.45)
text-error-foregroundvar(--pd-color-error-foreground)
error-subtle
error 的浅色背景。错误提示条与危险操作 hover 底色。避免:不要用于成功反馈。error-subtle-foreground
#ffe0e7
oklch(0.9341 0.0353 2.49)
#4a2934
oklch(0.3271 0.0515 358.91)
bg-error-subtlevar(--pd-color-error-subtle)
error-subtle-foreground
error 浅色背景上的文字。错误提示正文与校验失败文案。避免:不要用于中性警告。—
#81243b
oklch(0.4130 0.1274 10.08)
#ffb8c2
oklch(0.8512 0.0832 9.64)
text-error-subtle-foregroundvar(--pd-color-error-subtle-foreground)
error-border
error 状态区域的边界。错误提示条与校验失败描边。避免:不要用于普通结构边界。—
#e59aaa
oklch(0.7645 0.0917 5.50)
#84515f
oklch(0.4970 0.0706 2.18)
border-error-bordervar(--pd-color-error-border)
success
成功完成的状态。保存、同步、检查通过。避免:不要用于普通品牌强调。success-foreground
#347827
oklch(0.5104 0.1343 140.63)
#a6da95
oklch(0.8350 0.1079 138.15)
bg-successvar(--pd-color-success)
success-foreground
success 实心背景上的文字。实心成功徽标文字。避免:不要当作文字色用在浅色背景上。—
#ffffff
oklch(1.0000 0.0000 89.88)
#1e301d
oklch(0.2873 0.0414 143.18)
text-success-foregroundvar(--pd-color-success-foreground)
success-subtle
success 的浅色背景。成功提示条与已完成标签底色。避免:不要用于进行中状态。success-subtle-foreground
#ddf2d7
oklch(0.9384 0.0422 138.73)
#2d4430
oklch(0.3612 0.0447 147.93)
bg-success-subtlevar(--pd-color-success-subtle)
success-subtle-foreground
success 浅色背景上的文字。成功提示正文与已完成标签文字。避免:不要用于品牌强调。—
#315d28
oklch(0.4329 0.0955 140.31)
#c3edb5
oklch(0.9021 0.0866 137.95)
text-success-subtle-foregroundvar(--pd-color-success-subtle-foreground)
success-border
success 状态区域的边界。成功提示条与已完成卡片描边。避免:不要用于普通结构边界。—
#8bc47e
oklch(0.7634 0.1136 139.85)
#57795a
oklch(0.5411 0.0616 146.91)
border-success-bordervar(--pd-color-success-border)
tip
无状态性质的建议和技巧。推荐、辅助说明、轻量高亮。避免:不要表达系统信息状态。tip-foreground
#006b67
oklch(0.4763 0.0822 190.27)
#69c7bd
oklch(0.7691 0.0910 186.47)
bg-tipvar(--pd-color-tip)
tip-foreground
tip 实心背景上的文字。实心建议徽标文字。避免:不要当作文字色用在浅色背景上。—
#ffffff
oklch(1.0000 0.0000 89.88)
#182725
oklch(0.2585 0.0207 185.62)
text-tip-foregroundvar(--pd-color-tip-foreground)
tip-subtle
tip 的浅色背景。建议、推荐与轻量高亮底色。避免:不要表达系统状态。tip-subtle-foreground
#d8f2ef
oklch(0.9414 0.0275 188.30)
#274340
oklch(0.3596 0.0344 187.15)
bg-tip-subtlevar(--pd-color-tip-subtle)
tip-subtle-foreground
tip 浅色背景上的文字。建议与辅助说明正文。避免:不要用于信息或错误状态。—
#174f4c
oklch(0.3909 0.0573 190.00)
#b6e9e2
oklch(0.8967 0.0531 185.94)
text-tip-subtle-foregroundvar(--pd-color-tip-subtle-foreground)
tip-border
tip 区域的边界。建议卡片与提示条描边。避免:不要用于普通结构边界。—
#79bdb7
oklch(0.7514 0.0696 188.71)
#4f7772
oklch(0.5380 0.0455 186.11)
border-tip-bordervar(--pd-color-tip-border)