【PlantUML】-类图-布局，如何改变元素位置
写在前面
PlantUML属于自动布局。掌握好，是一件利器，掌握不好，就会不知其所以然。尤其在布局方面，因为它的布局可能会和你想的不太一样。本篇文章以例子为基础，简单地说几个在实际应用过程中摸索出来的原则。相信看完这篇文章（有示例），你就可以轻松驾驭PlantUML的布局，自由调动元素了。
目录
- 写在前面
- 一、基本概念
- 二、具体步骤
-
- 1.环境说明
- 2.自动布局
-
- 1 X 1 最多容纳1个元素
- 2 X 2 最多容纳4个元素
- 3 X 3 最多容纳9个元素
- 4 X 4 最多容纳16个元素
- 5 X 5 最多容纳25个元素
- 3.改变布局
-
- 3.1 水平结构
-
- 3.1.1 操作符 .
- 3.1.2 操作符 . 隐藏线条
- 3.1.3 操作符 -
- 3.1.4 添加注释 left或者right
- 3.2 垂直结构
-
- 3.2.1 操作符 - -
- 3.2.2 操作符 . .
- 3.2.3 添加注释top或者bottom
- 写在后面
- 系列文章
一、基本概念
布局，就是说当你添加元素后，这些元素是如何排列的，如何才能控制这些元素的位置达到自己想要的结果。
二、具体步骤
1.环境说明
| 名称 | 说明 |
|---|---|
| Windows | Windows10 |
| Intellij IDEA版本 | Intellij IDEA 2019.2.3(Ultimate Edition) |
| PlantUML Integration | IDEA插件 2.23.0 |
2.自动布局
PlantUML既然是自动布局的，那其中的元素是基于什么原则什么时候换行的？
其实，观察了一下，我称它为正方形布局。
下面先看例子和效果，
1 X 1 最多容纳1个元素
示例1：1个元素
@startuml
class 1{}
@enduml
其效果：占了1行
2 X 2 最多容纳4个元素
示例2：2个元素
@startuml
class 1{}
class 2{}
@enduml
其效果：占了1行
示例3：3个元素
@startuml
class 1{}
class 2{}
class 3{}
@enduml
其效果：1和2占了第1行，第3个元素占了第2行
示例4：4个元素
@startuml
class 1{}
class 2{}
class 3{}
class 4{}
@enduml
其效果：1和2是第1行，3和4是第2行
3 X 3 最多容纳9个元素
示例5：5个元素
@startuml
class 1{}
class 2{}
class 3{}
class 4{}
class 5{}
@enduml
其效果：5个元素的时候，1和2和3占据了第1行，4和5在第2行
示例6：9个元素
@startuml
class 1{}
class 2{}
class 3{}
class 4{}
class 5{}
class 6{}
class 7{}
class 8{}
class 9{}
@enduml
其效果：平均每行3个
4 X 4 最多容纳16个元素
示例7：10个元素
@startuml
class 1{}
class 2{}
class 3{}
class 4{}
class 5{}
class 6{}
class 7{}
class 8{}
class 9{}
class 10{}
@enduml
其效果：第1行由1，2，3变成了1，2，3，4
有没有发现什么规律？貌似在按照正方形来提前规划出位置，然后依次往里面填充元素。
什么意思呢？解释一下，什么叫正方形布局。
1x1:最多容纳1个元素，即1个元素占1行
2x2:最多容纳4个元素，即超过5个，布局就要变成 3X3，第1行就变成了3个元素
3x3:最多容纳9个元素，即超过9个，布局就要变成 4X4，第1行就变成了4个元素
...
验证一下猜想，超过16个元素会怎么样？
5 X 5 最多容纳25个元素
示例8：17个元素
@startuml
class 1{}
class 2{}
class 3{}
class 4{}
class 5{}
class 6{}
class 7{}
class 8{}
class 9{}
class 10{}
class 11{}
class 12{}
class 13{}
class 14{}
class 15{}
class 16{}
class 17{}
@enduml
其效果：布局变成了 5X5。
当超过25个元素时，会变成6X6布局，第1行也就会变成6个元素。
以上就是自动布局的原则，那有没有办法改变原有的布局方式呢？
当然有，接着往下看。
3.改变布局
改变布局就是改变元素的相对位置，给2个元素添加操作符。
先说结论，2个元素之间操作符如下，
以下是改变水平结构，
（1）- 或者 .
当前元素会向最左移动，占据纵向位置
其他元素仍按照原有的方式进行布局
（2）注释，note left或者right
当前元素会向最左移动，占据纵向位置，优先级高于（1）
同等注释，按元素先后位置排序
以下是改变垂直结构，
（1）-- 或者 ..
当前位置会向最右移动，占据纵向位置
其他元素仍按照原有的方式进行布局
（2）注释，note top或者bottom
当前元素会向最右移动，占据纵向位置，优先级低于（1）
同等注释，按元素先后位置排序
通用原则，
.和-的只是线条的表示区别，.个是虚线，-个是实线。
[hidden] 用于隐藏线条
以 3X3布局，9个元素为例，解释一下结论，
@startuml
class 1{}
class 2{}
class 3{}
class 4{}
class 5{}
class 6{}
class 7{}
class 8{}
class 9{}
@enduml
其效果：
3.1 水平结构
3.1.1 操作符 .
示例：把class 4 放在class 3的后边，位于同一行
@startuml
class 1{}
class 2{}
class 3{}
class 4{}
class 5{}
class 6{}
class 7{}
class 8{}
class 9{}
class 10{}
class 11{}
3 . 4
@enduml
效果，
3.1.2 操作符 . 隐藏线条
示例：把class 4 放在class 3的后边，位于同一行，但是隐藏线条。
@startuml
class 1{}
class 2{}
class 3{}
class 4{}
class 5{}
class 6{}
class 7{}
class 8{}
class 9{}
class 10{}
class 11{}
3 .[hidden] 4
@enduml
效果，
3.1.3 操作符 -
示例：把class 3 放在class 4的后边，位于同一行
@startuml
class 1{}
class 2{}
class 3{}
class 4{}
class 5{}
class 6{}
class 7{}
class 8{}
class 9{}
class 10{}
class 11{}
4 - 3
@enduml
效果，
3.1.4 添加注释 left或者right
@startuml
class 1{}
class 5{
}
note left of 5
注释
end note
class 2{
}
note left of 2
注释
end note
class 3{}
class 4{}
class 6{}
class 7{}
class 8{}
class 9{}
class 10{}
class 11{}
4 - 3
@enduml
效果，
3.2 垂直结构
3.2.1 操作符 - -
示例：把class 4 放在class 3的下边
@startuml
class 1{}
class 2{}
class 3{}
class 4{}
class 5{}
class 6{}
class 7{}
class 8{}
class 9{}
class 10{}
class 11{}
class 11{}
3 -- 4
@enduml
效果，
3.2.2 操作符 . .
示例：把class 3 放在class 43的下边
@startuml
class 1{}
class 2{}
class 3{}
class 4{}
class 5{}
class 6{}
class 7{}
class 8{}
class 9{}
class 10{}
class 11{}
class 11{}
4 .. 3
@enduml
效果，
3.2.3 添加注释top或者bottom
@startuml
class 1{}
class 5{
}
note bottom of 5
注释
end note
class 2{
}
note top of 2
注释
end note
class 3{}
class 4{}
class 6{}
class 7{}
class 8{}
class 9{}
class 10{}
class 11{}
4 -- 3
@enduml
至此，可以开启的你的UML大法了~
写在后面
如果本文内容对您有价值或者有启发的话，欢迎点赞、关注、评论和转发。您的反馈和陪伴将促进我们共同进步和成长。
系列文章
【PlantUML】-类图
【PlantUML】-时序图
【IDEA插件】- PlantUML integration-Can‘t find Graphviz