Appearance
Theme 与 Patina
Latte / Macchiato
Light 使用 Catppuccin Latte 的 neutral foundation;Dark 使用 Macchiato。主题通过根节点属性切换:
html
<html data-theme="latte">
<html data-theme="macchiato">兼容已有暗色模式工具链时,根节点 .dark 同样启用 Macchiato。业务代码无需追加 dark: 颜色分支。
为什么只有两套配色
Catppuccin 提供四个 flavor,本设计体系只采用 Latte 与 Macchiato,一对一映射亮色与暗色:
| Flavor | 角色 |
|---|---|
| Latte | 唯一亮色主题 |
| Macchiato | 唯一暗色主题 |
| Frappé | 不采用 |
| Mocha | 不采用 |
Frappé 与 Mocha 在明度上分别紧邻 Macchiato 与 Latte,同时引入会产生"四套看起来差不多的暗色"的歧义,也让品牌色、阴影与对比度测试成倍增长。两套配色已经足够覆盖亮暗两端,其余 flavor 的差异属于口味而非体系,因此不作为 Token 层的能力。
Patina tonal scale
Patina 来自铜绿、包浆与旧工业设备的时间感。Dark primary 使用 Windows 98 Teal #008080,并搭配白色前景。
该值已定稿:更亮的 #69c7bd 曾是候选对照方案,现已从样式表中移除,只在本文档保留记录。已确认的事实不再以可切换开关的形式长期存在——需要重新比较时,在 Playground 另开临时实验页。
Surface
Latte 使用 Base / Mantle / Crust 后再补充白色 elevated;Macchiato 使用 Crust / Mantle / Base / Surface 0。它们是经过语义重排的层级,不向业务暴露 Catppuccin 原名。