颜色
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)。切换页面顶部的主题模式即可查看实时计算值。
#明暗五大不对称法则
深色模式不是把浅色色阶简单倒序,五条不对称规则保证了暗色界面的层次与可读性:
- 实心前景极性翻转(
--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:先写属性,再写状态,角色放最后。组件映射不同类型时只需要替换最后一段。
.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() 实时派生的别名矩阵:
| surfacetint | surface-hoverhover | surface-pressedpress | tag-borderedtag | border-subtlesub | borderbdr | border-hoverhov | fillseed | fill-hoverhov | fill-pressedpress | textaa | text-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% 柔和光晕 |
点击下方任意输入框并切换页面顶部的明暗模式,即可对比浅色焦点环与深色微光槽。
#对比度
在浏览器内对当前主题实时采样(将半透明 color-mix() 表面叠加在 bg-page 与 bg-panel 上合成后计算)。全部彩色文字别名在浅色和深色模式下均满足 WCAG AA(4.5:1);实心填充在浅色下保持纯净白字,在深色下自动翻转为 #000000 黑字并达到 AAA 级对比度。
| pair | neutral | primary | accent | info | success | warning | error |
|---|---|---|---|---|---|---|---|
| text on bg-page | Aa— | Aa— | Aa— | Aa— | Aa— | Aa— | Aa— |
| text on bg-panel | Aa— | Aa— | Aa— | Aa— | Aa— | Aa— | Aa— |
| text on surface | Aa— | Aa— | Aa— | Aa— | Aa— | Aa— | Aa— |
| text on surface-pressed | Aa— | Aa— | Aa— | Aa— | Aa— | Aa— | Aa— |
| text-strong on surface | Aa— | Aa— | Aa— | Aa— | Aa— | Aa— | Aa— |
| text-on-fill on fill | Aa— | Aa— | Aa— | Aa— | Aa— | Aa— | Aa— |
#修改颜色
覆盖某组角色的种子变量,所有由 color-mix() 派生的浅底、描边、文字和焦点光晕都会自动联动,且 success 仍保持独立的翡翠绿:
<ConfigProvider
themeOverrides={{
"--p-seed-primary": "#2080f0",
"--p-seed-primary-hover": "#4098fc",
"--p-seed-primary-pressed": "#1060c9",
"--p-seed-primary-suppl": "#4098fc",
}}
>
…
</ConfigProvider>也可以只覆盖某个别名,单独修改某一种用途而不改动种子:
<ConfigProvider themeOverrides={{ "--pw-alias-fill-primary": "var(--p-seed-accent)" }}>…</ConfigProvider>