跳到正文

颜色

Pika 的颜色遵循 Naive UI 翡翠绿(Jade Green)三层架构。组件从不直接写具体色值:它只声明用途(例如“主按钮的实心填充”或“错误提示文字”),所有浅底、描边、文字和焦点光晕都由少量语义种子在浏览器内实时派生。

层命名存什么
种子与层级底色--p-seed-{role}、--p-base-color、--p-neutral-*6 组语义角色 × 4 个状态种子(default、hover、pressed、suppl)、实心前景极性与 Z 轴海拔底色
别名--pw-alias-{property}-{state}-{role}通过原生 CSS color-mix(in srgb, ...) 实时派生的用途变量
组件--pl-{component}-*组件自己的局部插槽;只读别名层

色板

系统不再维护冗长的 12 级静态色阶,而是为 6 个语义角色(primary、info、success、warning、error、accent)各定义 4 个状态种子:default、hover、pressed 与 suppl。浅色模式以清透的翡翠绿(#18a058)搭配 #ffffff 卡片与 #f6f7f9 画布;深色模式切换为低饱和薄荷绿(#63e2b7)与四阶曜石海拔(#101014 → #18181c → #2c2c32 → #48484e)。切换页面顶部的主题模式即可查看实时计算值。

defaulthoverpressedsupplprimaryjadeinfooceansuccessjadewarningambererrorcrimsonaccentterracotta
basepolarity
bg-pageL0 canvas
bg-panelL1 card
bg-modalL2 modal
bg-raisedL3 popover
bg-tooltiptooltip

明暗五大不对称法则

深色模式不是把浅色色阶简单倒序,五条不对称规则保证了暗色界面的层次与可读性:

  • 实心前景极性翻转(--p-base-color)。 浅色模式实心按钮(#18a058)配纯白字 #ffffff;深色模式将 --p-base-color 翻转为 #000000,让高明度薄荷绿实心按钮(#63e2b7)自动配纯黑字(对比度达 7.4:1–13.4:1 AAA)。
  • suppl 纯白前景托底锚点。 前景恒定为纯白的控件(如 Switch 的白色圆形滑块、Badge 实心胶囊)在深色模式下改读更沉稳的 --p-seed-{role}-suppl(#2a947d),避免浅薄荷绿底吃掉白色边缘。
  • 四阶 Z 轴曜石海拔。 浅色模式靠三档方向性阴影区分白色浮层;深色模式通过底色明度逐级抬升区分 bg-page(#101014)、bg-panel(#18181c)、bg-modal(#2c2c32)与 bg-raised(#48484e),Modal 内弹出的 Select 或 Popover 绝不糊底。
  • 半透明 color-mix() 叠色与按压反暗。 次级浅底直接与 transparent 混色,落在任意海拔层上都能自然融合。浅色按压逐级加深(12% → 17% → 22%);深色悬停提亮、按压反暗回落(16% → 20% → 12%),且有边框 Tag 在深色下采用 0% 纯透明底。
  • 浅色实线焦点环 vs 深色微光槽。 浅色输入框采用 #ffffff 底、细灰描边与聚焦 2px 实心外环(0 0 0 2px);深色输入框采用无描边 rgba(255, 255, 255, 0.1) 深槽,聚焦时亮起描边、透出 10% 主色微光底并散发 8px 柔和光晕(0 0 8px 0)。

别名

命名遵循 how-to-style:先写属性,再写状态,角色放最后。组件映射不同类型时只需要替换最后一段。

css
.p-button { &&--error-type { --pl-button-family-fill: var(--pw-alias-fill-error); --pl-button-family-fill-hover: var(--pw-alias-fill-hover-error); --pl-button-family-fill-pressed: var(--pw-alias-fill-pressed-error); --pl-button-family-text: var(--pw-alias-text-error); } }

七组角色及其由 color-mix() 实时派生的别名矩阵:

surfacetintsurface-hoverhoversurface-pressedpresstag-borderedtagborder-subtlesubborderbdrborder-hoverhovfillseedfill-hoverhovfill-pressedpresstextaatext-on-fillbase
neutralslate
primaryjade
accentterracotta
infoocean
successjade
warningamber
errorcrimson

中性文字与海拔表面拥有独立命名:--pw-alias-bg-page(L0 画布)、--pw-alias-bg-panel(L1 卡片)、--pw-alias-bg-modal(L2 弹窗与抽屉)、--pw-alias-bg-raised(L3 气泡菜单、下拉面板与分段控制器滑块)、--pw-alias-bg-tooltip、--pw-alias-label-primary / -secondary / -tertiary / -disabled、--pw-alias-border-strong 与 --pw-alias-border-focus。--pw-static-white 和 --pw-static-black 永远不变。

反馈色

表单校验与状态提示(info、success、warning、error)统一读取 --pw-feedback-{property}-{role},与角色种子同源派生,使报错 Input、Tag 与 Alert 保持完全一致的色相。

Token值(浅色和深色)
--pw-feedback-text-{role}--pw-alias-text-{role}(浅色混黑满足 WCAG AA 4.5:1,深色直接使用明亮粉彩种子)
--pw-feedback-border-{role}--p-seed-{role}(悬停时取 -hover)
--pw-feedback-shadow-{role}浅色 0 0 0 2px 20% 焦点环;深色 0 0 8px 0 30% 柔和光晕

点击下方任意输入框并切换页面顶部的明暗模式,即可对比浅色焦点环与深色微光槽。

info
Synced 2 minutes ago
success
Looks good
warning
Double-check this
error
Not a valid email

对比度

在浏览器内对当前主题实时采样(将半透明 color-mix() 表面叠加在 bg-page 与 bg-panel 上合成后计算)。全部彩色文字别名在浅色和深色模式下均满足 WCAG AA(4.5:1);实心填充在浅色下保持纯净白字,在深色下自动翻转为 #000000 黑字并达到 AAA 级对比度。

pairneutralprimaryaccentinfosuccesswarningerror
text on bg-pageAa—Aa—Aa—Aa—Aa—Aa—Aa—
text on bg-panelAa—Aa—Aa—Aa—Aa—Aa—Aa—
text on surfaceAa—Aa—Aa—Aa—Aa—Aa—Aa—
text on surface-pressedAa—Aa—Aa—Aa—Aa—Aa—Aa—
text-strong on surfaceAa—Aa—Aa—Aa—Aa—Aa—Aa—
text-on-fill on fillAa—Aa—Aa—Aa—Aa—Aa—Aa—

修改颜色

覆盖某组角色的种子变量,所有由 color-mix() 派生的浅底、描边、文字和焦点光晕都会自动联动,且 success 仍保持独立的翡翠绿:

tsx
<ConfigProvider themeOverrides={{ "--p-seed-primary": "#2080f0", "--p-seed-primary-hover": "#4098fc", "--p-seed-primary-pressed": "#1060c9", "--p-seed-primary-suppl": "#4098fc", }} > … </ConfigProvider>

也可以只覆盖某个别名,单独修改某一种用途而不改动种子:

tsx
<ConfigProvider themeOverrides={{ "--pw-alias-fill-primary": "var(--p-seed-accent)" }}>…</ConfigProvider>