第17章 创建自定义样式
创建自定义样式
主题负责为整个图表设置样式。classDef 则让你更进一步——只需定义一次命名样式,就能一致地应用到任意节点上。
用 classDef 定义样式
flowchart LR A[Request] --> B{Approved?} B -->|Yes| C[Move forward] B -->|No| D[Return for revision]
classDef decision fill:#f5f0ff,stroke:#7c3aed,color:#4c1d95 classDef endpoint fill:#ecfdf5,stroke:#059669,color:#064e3b
class B decision class C,D endpoint classDef 接收一个名称和一组 CSS 风格的属性,class 则按节点 ID 将样式应用到一个或多个节点。
样式属性:
属性 控制内容 fill 背景色 stroke 边框色 color 文字颜色 stroke-width 边框粗细 stroke-dasharray 虚线边框(如 5 5)
所有属性均支持十六进制颜色,便于精确控制色彩。
将样式应用到多个节点
class A,B,C myStyle 用逗号分隔节点 ID,它们都会应用同一个样式。
设置默认样式
为所有没有显式指定类的节点应用某个样式:
classDef default fill:#f9fafb,stroke:#d1d5db,color:#111827 适合用来建立基线样式,只覆盖那些需要突出的节点。
内联样式
只想对单个节点做一次性修改、不想定义类时:
A[Start]:::highlight classDef highlight fill:#fef9c3,stroke:#ca8a04 也可以在节点定义中直接用 style:
style A fill:#fef9c3,stroke:#ca8a04,color:#78350f 内联样式能用,但不好扩展——如果多个节点需要同样的效果,请用 classDef。
用 themeVariables 深度定制
想更深层次地控制整个图表的主色、字体、连线颜色,可以在 front matter 块中配合 base 主题使用 themeVariables:
--- config: theme: base themeVariables: primaryColor: "#f0f4ff" primaryTextColor: "#1e1b4b" primaryBorderColor: "#4f46e5" lineColor: "#6366f1" fontSize: "16px" --- flowchart LR A --> B --> C themeVariables 只在 base 主题下生效,搭配其他主题时不起作用。
常用 themeVariables:
变量 控制内容 primaryColor 节点默认填充色 primaryTextColor 节点默认文字颜色 primaryBorderColor 节点默认边框色 lineColor 连线颜色 secondaryColor 二级节点填充色 tertiaryColor 三级节点填充色 fontSize 基础字号 fontFamily 字体
完整的 themeVariables 参考见 OSS 主题文档 →
可视化编辑器中的 classDef
在可视化编辑器中修改节点颜色时,Mermaid 会自动在代码中生成相应的 classDef 条目。你可以直接在文本编辑器中编辑这些条目——可视化编辑器和文本编辑器保持同步。
用 Mermaid AI 生成自定义主题
如果手动调 themeVariables 或编写 classDef 块太繁琐,不妨直接描述你的需求。Mermaid AI 能把自然语言描述转换成可用的样式块,直接插入你的图表。
打开 AI 面板,告诉它你想要的效果:
"用柔和的紫色系来设计——浅色填充、深色文字,决策节点要有清晰的边框。"
它会返回已经接入代码的 themeVariables(或 classDef 条目,取决于你的要求)。返回结果和其他代码一样可以随意编辑——就是上面讲过的语法,只是帮你自动生成了。
效果较好的提示词示例:
目标 提示词 匹配品牌 "用我们的品牌色——藏青 #1e3a8a 和金色 #f59e0b" 营造氛围 "做得干净极简,多留些留白" 修正对比度 "文字看不清——把填充色上的文字加深一些"
因为输出的是普通的 themeVariables 和 classDef,本指南中的所有内容依然适用。你可以手动微调生成的样式、把类应用到更多节点,或设置默认样式。AI 帮你快速起步,剩下的手动控制来完成。
常见问题
样式没有生效。请检查 class 语句中的节点 ID 是否完全匹配——ID 区分大小写。常见错误是定义了 classDef myStyle,却用大写 M 引用了 class A MyStyle。
themeVariables 不起作用。请确认 front matter 中使用的是 theme: base。themeVariables 对其他任何主题都无效。
想在多个图表间保持样式一致。classDef 的作用范围仅限单个图表,不会跨图表生效。要在团队范围内保持一致,可以约定一个共享的样式块粘贴到每个图表中,或者用主题作为基线。
接下来
应用全站样式起点 | 应用主题 →
为节点添加图标 | 使用图标 →
保留样式导出 | 导出图表 →