第18章 Mermaid 图标使用指南:Font Awesome 图标在节点中的内联渲染与配置
使用图标
图标为节点增加视觉含义——能让复杂图表一目了然,而无需添加更多文字。
为节点添加图标
Mermaid 支持在节点标签中内联使用 Font Awesome 图标。用 fa: 前缀加上图标名称即可:
flowchart LR A(["fa:fa-user User"]) B(["fa:fa-server Server"]) C(["fa:fa-database Database"]) A --> B --> C
图标会随节点标签一起内联渲染。节点形状由括号决定——用 ([ 表示圆角矩形,这种形状配图标效果最好。
找到合适的图标
Font Awesome 图标名称遵循 fa-[name] 的格式。常用图标如下:
图标名称适合表示Userfa:fa-user用户、角色、终端用户Serverfa:fa-server后端系统Databasefa:fa-database数据存储Cloudfa:fa-cloud云服务Lockfa:fa-lock认证、安全Checkfa:fa-check审批、完成Envelopefa:fa-envelope邮件、通知Cogfa:fa-cog设置、配置Codefa:fa-code代码、APIFilefa:fa-file文档
完整图标库:Font Awesome icons →
Mermaid 的图标注册表还支持其他图标集。可以在编辑器左侧面板的 Icons 下浏览可用图标,或查看图标注册表参考文档 →
仅显示图标的节点
要只显示图标不带标签,把标签文本留空即可:
A(["fa:fa-user"])
在可视化编辑器中添加图标
在可视化编辑器中,点击中间工具栏的图标按钮。搜索图标后点击即可放置到画布上。放置后,可以在图标工具栏中设置图标大小、背景形状、背景颜色、图标颜色和标签。
常见问题
图标没有渲染。请检查图标名称是否正确并带有 fa: 前缀。图标名称区分大小写,必须完全匹配。如果不确定名称,可以在编辑器的图标面板中搜索。
图标和标签没有对齐。这通常是节点形状的问题——圆角矩形 ([ 最适合图标加标签的组合。如果对齐仍有问题,可以试试去掉标签,改用 tooltip 或单独的标签节点。
接下来做什么?
为图标节点应用颜色和样式 | 创建自定义样式 →
导出图表并保留图标 | 导出图表 →
与利益相关者分享图表 | 分享图表 →