首页
/ PlantUML笔记功能增强:全图表类型支持Stereotype样式

PlantUML笔记功能增强:全图表类型支持Stereotype样式

2025-05-20 12:41:11作者:侯霆垣

在最新版本的PlantUML中,开发团队对笔记功能进行了重要升级,使得Stereotype样式支持扩展到更多图表类型。这项改进显著提升了图表注释的可视化定制能力。

核心改进内容

本次功能增强主要解决了原先Stereotype样式在某些图表类型中无法应用于笔记的问题。通过代码层面的统一处理,现在用户可以在以下图表类型中使用带Stereotype的笔记:

  1. 活动图:支持在活动节点旁添加带样式的浮动笔记
  2. 时序图:支持在时间轴上方或下方添加带样式的注释
  3. 甘特图:支持在任务条下方添加带样式的说明性笔记

技术实现解析

开发团队通过重构多个命令处理类来实现这一功能:

  • 活动图模块重构了CommandNote3和CommandNoteLong3类
  • 时序图模块改进了CommandNote和CommandNoteLong类
  • 甘特图模块调整了CommandNoteBottom类的实现

这些修改使得笔记命令能够正确解析和处理Stereotype参数,并应用对应的CSS样式定义。

实际应用示例

以下是一个典型的使用案例,展示如何在甘特图中应用带Stereotype的笔记:

@startgantt
<style>
.customNote {
    backgroundcolor #D5E8D4
    Linecolor #82B366
    LineThickness 3
    fontcolor #1E4D2B
}
</style>

[需求分析] as [ra] requires 5d
note bottom <<customNote>>
  主要任务:
  - 收集用户需求
  - 编写需求文档
  - 评审确认
end note

[ra] -> [设计阶段]
@endgantt

这个示例展示了如何通过自定义Stereotype为甘特图中的任务添加具有统一视觉风格的说明性注释。

样式定制指南

用户可以通过<style>块定义Stereotype样式,支持的常用属性包括:

  • backgroundcolor:设置笔记背景色
  • Linecolor:定义边框颜色
  • LineThickness:调整边框粗细
  • fontcolor:改变文字颜色
  • fontstyle:设置字体样式(如斜体)
  • fontsize:调整字体大小

版本兼容性说明

此功能已在PlantUML V1.2024.6及后续版本中实现。对于需要跨版本兼容的项目,建议在使用前进行版本检测或提供备用样式方案。

这项改进使得PlantUML的注释功能更加统一和强大,为技术文档的编写提供了更丰富的可视化表达手段。用户现在可以在各类图表中保持一致的注释风格,提升文档的专业性和可读性。

登录后查看全文
热门项目推荐
相关项目推荐