color.md
基础 · FOUNDATION

色彩 Color

黑、白、朱砂红。红只出现一次,永远标「你在这里 / 下一步」。白就是中性白,不偏暖。同一套角色有浅色与深色两套数值。

品牌与底面

样本令牌浅色深色用途
#A6402F同浅色
#A6402F#E27D67朱字:链接、提示、错误等文字用的朱色
rgba(166, 64, 47, 0.04)rgba(226, 125, 103, 0.07)朱色大面积浅染(已完成卡底)
rgba(166, 64, 47, 0.35)rgba(226, 125, 103, 0.42)朱色描边(已完成卡边)
rgba(166, 64, 47, 0.08)rgba(226, 125, 103, 0.14)朱色小面积底(朱字标签、双链胶囊)
#F6F6F4#141413应用画布 / 侧栏底
#FFFFFF#1C1C1B主内容面 / 卡片
#FFFFFF#242423浮层:确认窗、下拉、浮动面板
#FDFDFC#121211输入槽内凹底
#161616#E6E5DF主文字墨色
#1D1D1B#EFEEE9深墨(黑胶囊 CTA、圆徽底)
#000000#FFFFFF墨的极值(深墨键悬停再压一档)
#FFFFFF#151514墨底上的字与图标
#EFEFEC#272725骨架块、中性标签底、空格子
#FBFBFA#1F1F1E插图灰阶 1–5:示意图里的屏幕底、侧栏、文字条(由浅到深)
#F1F1EE#262624
#E7E7E3#2E2E2C
#E2E2DE#353533
#DBDBD6#3C3C39
#2E7D4F#6FCB8E成功提示字色
rgba(0, 0, 0, 0.04)rgba(255, 255, 255, 0.04)行悬停
rgba(0, 0, 0, 0.07)rgba(255, 255, 255, 0.08)导航选中、按下
rgba(22, 22, 22, 0.46)rgba(0, 0, 0, 0.62)确认窗遮罩(只降亮、不模糊)
rgba(0, 0, 0, 0.3)rgba(255, 255, 255, 0.3)悬停高亮描边(卡片/胶囊/线框键)
rgba(166, 64, 47, .55)rgba(226, 125, 103, .6)

品牌朱有三个可选值 #A6402F(默认)/ #8C3A31 / #B5543F,由外壳在运行时注入 --zzm-accent。任何颜色引用都写 var(--zzm-accent, #A6402F),脱离外壳也有正确兜底。文字选区用朱色 16% 透明:rgba(166,64,47,.16)。

文字灰阶

样本令牌浅色深色用途
#26261F#DCDBD5
#3F3F3B#C8C7C1
#4A4A46#BBBAB4
#6E6E6A#A3A29C
#72726E#9C9B95
#71716C#8D8C86白底与纸面对比度 ≥4.5(v0.11.0)
#82827D#85847C≈3.6,保留由深到浅的层次
#8F8F8A#77766F≥3.0,大字与装饰文字线
#C6C6C0#4E4D49

正文用 text-2,说明文字用 text-5,元数据与标签用 muted-2,分隔符用 faint。灰都带一点点黄绿偏(例如 #71716C 而不是 #717171),和纸面同一个色温。

暗底

只用在封面、播放器、付款页这类「放内容」的深色面上。深色主题下它们不翻成浅色,只微调到能与深色纸面区分。

样本令牌浅色深色用途
#1D1D1B#0F0F0E深色展台:推荐方案等两套主题都保持深色的大面
#131316#0F0F10
#0E0E10#0C0C0D
#0B0B0C#0B0B0C

细线三档

黑色微透明只允许三档,同一用途同一档。深于 .18 的深色遮罩和滚动条不算细线。

样本令牌浅色深色用途
rgba(0, 0, 0, 0.07)rgba(255, 255, 255, 0.07)
rgba(0, 0, 0, 0.09)rgba(255, 255, 255, 0.1)
rgba(0, 0, 0, 0.14)rgba(255, 255, 255, 0.16)

课时档位信号色

黑白系统里唯一被允许的功能色,只用在档位胶囊上(见徽章与档位)。每档三件套:实色、浅底、深字。

样本令牌浅色深色用途
#16A34A#3FB96A免费 · 绿
rgba(22, 163, 74, 0.12)rgba(74, 222, 128, 0.14)
#157F3C#6FCB8E
#E0920A#F0A928会员 · 黄金
rgba(224, 146, 10, 0.18)rgba(240, 169, 40, 0.16)
#8A5606#F0B44C
#A6402F#D2624C拓展 · 红(品牌朱同族)
rgba(166, 64, 47, 0.11)rgba(226, 125, 103, 0.16)
#A6402F#E8826C

组件里的字面量对照

v4 组件大量直接写色值而不是 CSS 变量。复刻时遇到下面这些字面量,它们对应的就是这些令牌:

字面量令牌常见位置
#161616--zzm-ink标题、当前项文字
#1D1D1B--zzm-ink-strong墨键底、圆徽、开关开启、选中复选框
#3F3F3B--zzm-text-2正文、纸键文字
#72726E--zzm-text-5卡片简介
#71716C--zzm-muted面包屑、说明、元数据
#82827D--zzm-muted-2mono 小标签、表头
#C6C6C0--zzm-faint面包屑分隔符
#131316--zzm-dark-card封面与缩略图暗底
rgba(0,0,0,.09)--zzm-hairline-2卡片描边
#EFEFEC--zzm-chip骨架块、中性标签底、空格子
#FFFFFF(底色)--zzm-surface卡片、主内容面;墨底上的白字用 --zzm-on-ink

深色主题

夜间护眼用的第二套颜色。消费方在外壳根上写 data-theme="dark"(课程站按系统外观自动切换,不设开关);任何子树写 data-theme="light" 整块回到浅色,例如付款二维码所在的白色收银卡。

深色不是反相:纸面压到深暖灰(不是纯黑),卡面比纸面亮一档,正文是浅墨(不是纯白),避免夜里高反差刺眼;墨键翻成浅瓷键,仍是全屏最重的那颗键;朱色分填充(--zzm-accent,键底不变)与文字(--zzm-accent-ink,深色下提亮)两个角色。组件只写令牌,不写 [data-theme] 分支——主题就是令牌值。

学习热力

样本令牌浅色深色用途
#EFEFEC#272725
#E4C7C0#4B2C25
#C98070#85402F
#A6402F#CF5B44

材质(微拟物光照)

按钮、卡片、输入槽、确认窗的面色渐变与投影组也是令牌。两套主题的光照模型完全一致(顶部反光、贴地投影、反光光晕、按压内陷),深色只换强弱与明暗。

样本令牌浅色深色用途
rgba(166, 64, 47, .16)rgba(226, 125, 103, .3)
rgba(255, 255, 255, .65)rgba(255, 255, 255, .05)骨架微光
rgba(255, 255, 255, .85)rgba(255, 255, 255, .22)档位胶囊反光
rgba(0, 0, 0, .03)rgba(255, 255, 255, .035)极轻行悬停
rgba(22, 22, 22, .07)rgba(255, 255, 255, .08)输入聚焦光晕
Aa0 10px 30px rgba(0, 0, 0, .07)0 10px 30px rgba(0, 0, 0, .45)
Aa0 1px 2px rgba(0, 0, 0, .04)0 1px 2px rgba(0, 0, 0, .3)
Aa0 10px 30px rgba(0, 0, 0, .09), 0 1px 2px rgba(0, 0, 0, .04)0 10px 30px rgba(0, 0, 0, .5), 0 1px 2px rgba(0, 0, 0, .3)
Aa0 1px 2px rgba(0, 0, 0, .04), 0 6px 18px rgba(0, 0, 0, .05), inset 0 1px 0 rgba(255, 255, 255, .85)0 1px 2px rgba(0, 0, 0, .4), 0 6px 18px rgba(0, 0, 0, .22), inset 0 1px 0 rgba(255, 255, 255, .035)
Aa0 1px 2px rgba(0, 0, 0, .10), 0 18px 48px rgba(0, 0, 0, .22), inset 0 1px 0 rgba(255, 255, 255, .92)0 1px 2px rgba(0, 0, 0, .5), 0 18px 48px rgba(0, 0, 0, .6), inset 0 1px 0 rgba(255, 255, 255, .05)
Aainset 0 1.5px 3px rgba(0, 0, 0, .06), inset 0 1px 1px rgba(0, 0, 0, .04)inset 0 1.5px 3px rgba(0, 0, 0, .45), inset 0 1px 1px rgba(0, 0, 0, .3)
#3F3F3B#D6D5CF
rgba(0, 0, 0, .14)rgba(255, 255, 255, .12)
rgba(0, 0, 0, .18)rgba(255, 255, 255, .2)
Aalinear-gradient(180deg, #FFFFFF 0%, #F2F2EF 100%)linear-gradient(180deg, #2D2D2B 0%, #232322 100%)
Aalinear-gradient(180deg, #ECECE9 0%, #F4F4F1 100%)linear-gradient(180deg, #1A1A19 0%, #212120 100%)
Aa0 0 0 3px rgba(255, 255, 255, .55), 0 1px 2px rgba(0, 0, 0, .09), 0 2px 6px rgba(0, 0, 0, .06), inset 0 1px 0 rgba(255, 255, 255, .92), inset 0 -1px 0 rgba(0, 0, 0, .05)0 0 0 3px rgba(255, 255, 255, .02), 0 1px 2px rgba(0, 0, 0, .5), 0 2px 6px rgba(0, 0, 0, .32), inset 0 1px 0 rgba(255, 255, 255, .07), inset 0 -1px 0 rgba(0, 0, 0, .3)
Aa0 0 0 4px rgba(255, 255, 255, .8), 0 2px 4px rgba(0, 0, 0, .10), 0 4px 12px rgba(0, 0, 0, .09), inset 0 1px 0 rgba(255, 255, 255, .95), inset 0 -1px 0 rgba(0, 0, 0, .05)0 0 0 4px rgba(255, 255, 255, .035), 0 2px 4px rgba(0, 0, 0, .5), 0 4px 12px rgba(0, 0, 0, .4), inset 0 1px 0 rgba(255, 255, 255, .09), inset 0 -1px 0 rgba(0, 0, 0, .3)
Aa0 0 0 3px rgba(255, 255, 255, .45), 0 1px 0 rgba(255, 255, 255, .65), inset 0 2px 4px rgba(0, 0, 0, .13), inset 0 1px 2px rgba(0, 0, 0, .09)0 0 0 3px rgba(255, 255, 255, .02), 0 1px 0 rgba(255, 255, 255, .04), inset 0 2px 4px rgba(0, 0, 0, .55), inset 0 1px 2px rgba(0, 0, 0, .4)
Aa0 0 0 3px rgba(166, 64, 47, .20), 0 1px 2px rgba(0, 0, 0, .09), 0 2px 6px rgba(0, 0, 0, .06), inset 0 1px 0 rgba(255, 255, 255, .92)0 0 0 3px rgba(226, 125, 103, .35), 0 1px 2px rgba(0, 0, 0, .5), 0 2px 6px rgba(0, 0, 0, .32), inset 0 1px 0 rgba(255, 255, 255, .07)
Aa0 0 0 3px rgba(255, 255, 255, .55), 0 1px 2px rgba(0, 0, 0, .09), 0 2px 6px rgba(0, 0, 0, .06), inset 0 1px 0 rgba(255, 255, 255, .92)0 0 0 3px rgba(255, 255, 255, .02), 0 1px 2px rgba(0, 0, 0, .5), 0 2px 6px rgba(0, 0, 0, .32), inset 0 1px 0 rgba(255, 255, 255, .07)
Aainset 0 2px 4px rgba(0, 0, 0, .12)inset 0 2px 4px rgba(0, 0, 0, .5)
#F2F2EF#1E1E1D禁用键灰面
rgba(0, 0, 0, .08)rgba(255, 255, 255, .06)
Aainset 0 1px 0 rgba(255, 255, 255, .7), 0 1px 2px rgba(0, 0, 0, .04)none
#FFFFFF#151514
rgba(0, 0, 0, .85)rgba(255, 255, 255, .55)
Aalinear-gradient(180deg, #3A3A36 0%, #1D1D1B 58%, #141412 100%)linear-gradient(180deg, #F2F1EC 0%, #E2E1DB 58%, #D5D4CE 100%)
Aalinear-gradient(180deg, #101010 0%, #22221F 100%)linear-gradient(180deg, #C9C8C2 0%, #DAD9D3 100%)
Aabrightness(1.12)brightness(1.04)
Aa0 0 0 3px rgba(22, 22, 22, .06), 0 1px 2px rgba(0, 0, 0, .18), 0 3px 10px rgba(22, 22, 22, .24), inset 0 1px 0 rgba(255, 255, 255, .20), inset 0 -1px 0 rgba(0, 0, 0, .38)0 0 0 3px rgba(255, 255, 255, .04), 0 1px 2px rgba(0, 0, 0, .5), 0 3px 10px rgba(0, 0, 0, .4), inset 0 1px 0 rgba(255, 255, 255, .7), inset 0 -1px 0 rgba(0, 0, 0, .16)
Aa0 0 0 4px rgba(22, 22, 22, .09), 0 2px 4px rgba(0, 0, 0, .20), 0 5px 14px rgba(22, 22, 22, .28), inset 0 1px 0 rgba(255, 255, 255, .24), inset 0 -1px 0 rgba(0, 0, 0, .38)0 0 0 4px rgba(255, 255, 255, .06), 0 2px 4px rgba(0, 0, 0, .5), 0 5px 14px rgba(0, 0, 0, .45), inset 0 1px 0 rgba(255, 255, 255, .75), inset 0 -1px 0 rgba(0, 0, 0, .16)
Aa0 0 0 3px rgba(22, 22, 22, .06), inset 0 2px 5px rgba(0, 0, 0, .55), inset 0 1px 2px rgba(0, 0, 0, .4)0 0 0 3px rgba(255, 255, 255, .04), inset 0 2px 5px rgba(0, 0, 0, .28), inset 0 1px 2px rgba(0, 0, 0, .2)

铁律

✓ 要同一屏只出现一处朱色,标当前位置或下一步
✗ 不要鲜艳纯红,或把朱色当装饰
✓ 要颜色写 var(--zzm-*),带字面量兜底;深浅两套由令牌切换
✗ 不要整页 filter: invert() 反相做深色,或在组件里写深色分支
✗ 不要奶油色、米色暖底
✓ 要朱色只做冗余信号:旁边总有图标或文字
✗ 不要档位色(绿 / 黄)出现在档位胶囊以外的地方