Skip to content

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 原名。