PlantUMLLanguage specificationClass Diagram

类图
Edit in DokuwikiEdit in AsciidocEdit in Markdown

元素声明
Edit in DokuwikiEdit in AsciidocEdit in Markdown

🎉 Copied! 
@startuml
abstract        抽象
abstract class  抽象(等同abstract)
annotation      注解
circle          圆
()              圆缩写形式
class           类
diamond         菱形
<>              菱形写形式
entity          实例
enum            枚举
interface       接口
@enduml

类之间的关系
Edit in DokuwikiEdit in AsciidocEdit in Markdown

类之间的关系通过下面的符号定义 :

Type Symbol Drawing
Extension（扩展） <|--
Composition（组合） *--
Aggregation（聚合） o--

使用.. 来代替 -- 可以得到点 线.

在这些规则下，也可以绘制下列图形

🎉 Copied! 
@startuml
Class01 <|-- Class02
Class03 *-- Class04
Class05 o-- Class06
Class07 .. Class08
Class09 -- Class10
@enduml

🎉 Copied! 
@startuml
Class11 <|.. Class12
Class13 --> Class14
Class15 ..> Class16
Class17 ..|> Class18
Class19 <--* Class20
@enduml

🎉 Copied! 
@startuml
Class21 #-- Class22
Class23 x-- Class24
Class25 }-- Class26
Class27 +-- Class28
Class29 ^-- Class30
@enduml

关系上的标签
Edit in DokuwikiEdit in AsciidocEdit in Markdown

在关系之间使用标签来说明时, 使用 :后接 标签文字。

对元素的说明，你可以在每一边使用 "" 来说明.

🎉 Copied! 
@startuml

类01 "1" *-- "many" 类02 : 包含

类03 o-- 类04 : 聚合

类05 --> "1" 类06

@enduml

在标签的开始或结束位置添加< 或 >以表明是哪个对象作用到哪个对象上。

🎉 Copied! 
@startuml
class 汽车

发动机 - 汽车 : 驱动 >
汽车 *- 轮子 : 拥有 4 >
汽车 -- 人 : < 所属

@enduml

添加方法
Edit in DokuwikiEdit in AsciidocEdit in Markdown

为了声明字段(对象属性）或者方法，你可以使用 后接字段名或方法名。

系统检查是否有括号来判断是方法还是字段。

🎉 Copied! 
@startuml
Object <|-- ArrayList

Object : equals()
ArrayList : Object[] elementData
ArrayList : size()

@enduml

也可以使用{} 把字段或者方法括起来

注意，这种语法对于类型/名字的顺序是非常灵活的。

🎉 Copied! 
@startuml
class Dummy {
  String data
  void methods()
}

class Flight {
   flightNumber : Integer
   departureTime : Date
}
@enduml

你可以（显式地）使用 {field} 和 {method} 修饰符来覆盖解析器的对于字段和方法的默认行为

🎉 Copied! 
@startuml
class Dummy {
  {field} A field (despite parentheses)
  {method} Some method
}

@enduml

定义可访问性
Edit in DokuwikiEdit in AsciidocEdit in Markdown

一旦你定义了域或者方法，你可以定义 相应条目的可访问性质。

Character Icon for field Icon for method Visibility
- private
# protected
~ package private
+ public

🎉 Copied! 
@startuml

class Dummy {
 -field1
 #field2
 ~method1()
 +method2()
}

@enduml

你可以采用以下命令停用这些特性 skinparam classAttributeIconSize 0 ：

🎉 Copied! 
@startuml
skinparam classAttributeIconSize 0
class Dummy {
 -field1
 #field2
 ~method1()
 +method2()
}

@enduml

WARNING
 This translation need to be updated. 
WARNING

抽象与静态
Edit in DokuwikiEdit in AsciidocEdit in Markdown

通过修饰符{static}或者{abstract}，可以定义静态或者抽象的方法或者属性。

这些修饰符可以写在行的开始或者结束。也可以使用{classifier}这个修饰符来代替{static}.

🎉 Copied! 
@startuml
class Dummy {
  {static} String id
  {abstract} void methods()
}
@enduml

高级类体
Edit in DokuwikiEdit in AsciidocEdit in Markdown

PlantUML默认自动将方法和属性重新分组，你可以自己定义分隔符来重排方法和属性，下面的分隔符都是可用的：--..==__.

还可以在分隔符中添加标题：

🎉 Copied! 
@startuml
class Foo1 {
  You can use
  several lines
  ..
  as you want
  and group
  ==
  things together.
  __
  You can have as many groups
  as you want
  --
  End of class
}

class User {
  .. Simple Getter ..
  + getName()
  + getAddress()
  .. Some setter ..
  + setName()
  __ private data __
  int age
  -- encrypted --
  String password
}

@enduml

备注和模板
Edit in DokuwikiEdit in AsciidocEdit in Markdown

模板通过类关键字("<<"和">>")来定义

你可以使用note left of , note right of , note top of , note bottom of这些关键字来添加备注。

你还可以在类的声明末尾使用note left, note right,note top, note bottom来添加备注。

此外，单独用note这个关键字也是可以的，使用 .. 符号可以作出一条连接它与其它对象的虚线。

🎉 Copied! 
@startuml
class Object << general >>
Object <|--- ArrayList

note top of Object : In java, every class\nextends this one.

note "This is a floating note" as N1
note "This note is connected\nto several objects." as N2
Object .. N2
N2 .. ArrayList

class Foo
note left: On last defined class

@enduml

更多注释
Edit in DokuwikiEdit in AsciidocEdit in Markdown

可以在注释中使用部分html标签：

  • <b>
  • <u>
  • <i>
  • <s>, <del>, <strike>
  • <font color="#AAAAAA"> or <font color="colorName">
  • <color:#AAAAAA> or <color:colorName>
  • <size:nn> to change font size
  • <img src="file"> or <img:file>: the file must be accessible by the filesystem

你也可以在注释中展示多行。

你也可以在定义的class之后直接使用 note left, note right, note top, note bottom 来定义注释。

🎉 Copied! 
@startuml

class Foo
note left: On last defined class

note top of Object
  In java, <size:18>every</size> <u>class</u>
  <b>extends</b>
  <i>this</i> one.
end note

note as N1
  This note is <u>also</u>
  <b><color:royalBlue>on several</color>
  <s>words</s> lines
  And this is hosted by <img:sourceforge.jpg>
end note

@enduml

WARNING
 This translation need to be updated. 
WARNING

注释属性 (field, attribute, member) 或方法
Edit in DokuwikiEdit in AsciidocEdit in Markdown

可以在字段（field、attribute、member）或方法上添加注释。 这不能与命名空间分隔符(namespaceSeparator) :: 一起使用

注释属性或方法

🎉 Copied! 
@startuml
class A {
{static} int counter
+void {abstract} start(int timeout)
}
note left of A::counter
  该成员已注释
end note
note right of A::start
  在 UML 注释了此方法
end note
@enduml

给同名方法注释

🎉 Copied! 
@startuml
class A {
{static} int counter
+void {abstract} start(int timeoutms)
+void {abstract} start(Duration timeout)
}
note left of A::counter
  该成员已注释
end note
note right of A::"start(int timeoutms)"
  这个start方法的参数是int类型
end note
note right of A::"start(Duration timeout)"
  这个start方法的参数是Duration类型
end note
@enduml

[Ref. QA-3474 and QA-5835]

WARNING
 This translation need to be updated. 
WARNING

链接的注释
Edit in DokuwikiEdit in AsciidocEdit in Markdown

在定义链接之后，你可以用 note on link 给链接添加注释

如果想要改变注释相对于标签的位置，你也可以用 note left on link， note right on link， note bottom on link。（对应位置分别在label的左边，右边，下边）

🎉 Copied! 
@startuml

class Dummy
Dummy --> Foo : A link
note on link #red: note that is red

Dummy --> Foo2 : Another link
note right on link #blue
this is my note on right link
and in blue
end note

@enduml

抽象类和接口
Edit in DokuwikiEdit in AsciidocEdit in Markdown

用关键字abstract或abstract class来定义抽象类。

抽象类用斜体显示。

也可以使用interface, annotation 和 enum 等关键字。

🎉 Copied! 
@startuml

abstract class AbstractList
abstract AbstractCollection
interface List
interface Collection

List <|-- AbstractList
Collection <|-- AbstractCollection

Collection <|- List
AbstractCollection <|- AbstractList
AbstractList <|-- ArrayList

class ArrayList {
  Object[] elementData
  size()
}

enum TimeUnit {
  DAYS
  HOURS
  MINUTES
}

annotation SuppressWarnings

@enduml

*[参考: '注解和成员' Issue#458]*
WARNING
 This translation need to be updated. 
WARNING

使用非字母字符
Edit in DokuwikiEdit in AsciidocEdit in Markdown

如果你想在类（或者枚举）的显示中使用非字母符号，你可以：
  • 在类的定义中使用 as 关键字
  • 在类名旁边加上 ""

🎉 Copied! 
@startuml
class "This is my class" as class1
class class2 as "It works this way too"

class2 *-- "foo/dummy" : use
@enduml

隐藏属性、函数等
Edit in DokuwikiEdit in AsciidocEdit in Markdown

通过使用命令“hide/show”，你可以用参数表示类的显示方式。

基础命令是: hide empty members. 这个命令会隐藏空白的方法和属性。

除 empty members 外，你可以用:
  • empty fields 或者 empty attributes 空属性,
  • empty methods 空函数，
  • fields 或 attributes 隐藏字段或属性，即使是被定义了
  • methods 隐藏方法，即使是被定义了
  • members 隐藏字段 和 方法，即使是被定义了
  • circle 类名前带圈的，
  • stereotype 原型。

同样可以使用 hide 或 show 关键词，对以下内容进行设置：
  • class 所有类，
  • interface 所有接口，
  • enum 所有枚举，
  • <<foo1>> 实现 foo1 的类，
  • 一个既定的类名。

你可以使用 show/hide 命令来定义相关规则和例外。

🎉 Copied! 
@startuml

class Dummy1 {
  +myMethods()
}

class Dummy2 {
  +hiddenMethod()
}

class Dummy3 <<Serializable>> {
String name
}

hide members
hide <<Serializable>> circle
show Dummy1 methods
show <<Serializable>> fields

@enduml

隐藏类
Edit in DokuwikiEdit in AsciidocEdit in Markdown

你也可以使用 show/hide 命令来隐藏类

如果你定义了一个大的!included 文件，且想在文件包含之后隐藏部分类，该功能会很有帮助。

🎉 Copied! 
@startuml

class Foo1
class Foo2

Foo2 *-- Foo1

hide Foo2

@enduml

WARNING
 This translation need to be updated. 
WARNING

删除类
Edit in DokuwikiEdit in AsciidocEdit in Markdown

您还可以使用remove命令来删除类。

如果您定义了一个大的 [!included file]（预处理）， 并且如果您想在 [file contains]（预处理）之后删除一些类，这可能很有用。

🎉 Copied! 
@startuml

class Foo1
class Foo2

Foo2 *-- Foo1

remove Foo2

@enduml

隐藏或删除未关联的类
Edit in DokuwikiEdit in AsciidocEdit in Markdown

默认情况下, 所有的类都将会展示:

🎉 Copied! 
@startuml
class C1
class C2
class C3
C1 -- C2
@enduml

不过你可以使用:
  • hide @unlinked 来隐藏未关联的类:

🎉 Copied! 
@startuml
class C1
class C2
class C3
C1 -- C2

hide @unlinked
@enduml

  • 或者使用 remove @unlinked 来删除未关联的类:

🎉 Copied! 
@startuml
class C1
class C2
class C3
C1 -- C2

remove @unlinked
@enduml

[Adapted from QA-11052]

泛型（generics）
Edit in DokuwikiEdit in AsciidocEdit in Markdown

你可以用 < 和 > 来定义类的泛型。

🎉 Copied! 
@startuml

class Foo<? extends Element> {
  int size()
}
Foo *- Element

@enduml

It is possible to disable this drawing using skinparam genericDisplay old command.

指定标记（Spot）
Edit in DokuwikiEdit in AsciidocEdit in Markdown

通常标记字符 (C, I, E or A) 用于标记 类(classes), 接口（interface）, 枚举（enum）和 抽象类（abstract classes）.

但是当你想定义原型时，可以增加对应的单个字符及颜色，来定义自己的标记（spot），就像下面一样：

🎉 Copied! 
@startuml

class System << (S,#FF7700) Singleton >>
class Date << (D,orchid) >>
@enduml

包
Edit in DokuwikiEdit in AsciidocEdit in Markdown

你可以通过关键词 package 声明包，同时可选的来声明对应的背景色（通过使用html色彩代码或名称）。

注意：包可以被定义为嵌套。

🎉 Copied! 
@startuml

package "Classic Collections" #DDDDDD {
  Object <|-- ArrayList
}

package net.sourceforge.plantuml {
  Object <|-- Demo1
  Demo1 *- Demo2
}

@enduml

包样式
Edit in DokuwikiEdit in AsciidocEdit in Markdown

包可以定义不同的样式。

你可以通过以下的命令来设置默认样式 : skinparam packageStyle,或者对包使用对应的模板:

🎉 Copied! 
@startuml
scale 750 width
package foo1 <<Node>> {
  class Class1
}

package foo2 <<Rectangle>> {
  class Class2
}

package foo3 <<Folder>> {
  class Class3
}

package foo4 <<Frame>> {
  class Class4
}

package foo5 <<Cloud>> {
  class Class5
}

package foo6 <<Database>> {
  class Class6
}

@enduml

你也可以参考下面的示例来定义包之间的连线:

🎉 Copied! 
@startuml

skinparam packageStyle rectangle

package foo1.foo2 {
}

package foo1.foo2.foo3 {
  class Object
}

foo1.foo2 +-- foo1.foo2.foo3

@enduml

命名空间（Namespaces）
Edit in DokuwikiEdit in AsciidocEdit in Markdown

在使用包（package）时（区别于命名空间），类名是类的唯一标识。 也就意味着，在不同的包（package）中的类，不能使用相同的类名。

在那种情况下（译注：同名、不同全限定名类），你应该使用命名空间来取而代之。

你可以从其他命名空间，使用全限定名来引用类， 默认命名空间（译注：无名的命名空间）下的类，以一个“."开头（的类名）来引用（译注：示例中的BaseClass).

注意：你不用显示地创建命名空间：一个使用全限定名的类会自动被放置到对应的命名空间。

🎉 Copied! 
@startuml

class BaseClass

namespace net.dummy #DDDDDD {
    .BaseClass <|-- Person
    Meeting o-- Person

    .BaseClass <|- Meeting
}

namespace net.foo {
  net.dummy.Person  <|- Person
  .BaseClass <|-- Person

  net.dummy.Meeting o-- Person
}

BaseClass <|-- net.unused.Person

@enduml

自动创建命名空间
Edit in DokuwikiEdit in AsciidocEdit in Markdown

使用命令 set namespaceSeparator ??? 你可以自定义命名空间分隔符（为 “.” 以外的字符）.

🎉 Copied! 
@startuml

set namespaceSeparator ::
class X1::X2::foo {
  some info
}

@enduml

禁止自动创建包则可以使用 set namespaceSeparator none.

🎉 Copied! 
@startuml

set namespaceSeparator none
class X1.X2.foo {
  some info
}

@enduml

棒棒糖接口
Edit in DokuwikiEdit in AsciidocEdit in Markdown

需要定义棒棒糖样式的接口时可以遵循以下语法:

  • bar ()- foo
  • bar ()-- foo
  • foo -() bar

🎉 Copied! 
@startuml
class foo类
bar ()- foo类
@enduml

改变箭头方向
Edit in DokuwikiEdit in AsciidocEdit in Markdown

类之间默认采用两个破折号 -- 显示出垂直 方向的线. 要得到水平方向的可以像这样使用单破折号 (或者点):

🎉 Copied! 
@startuml
教室 o- 学生
教室 *-- 椅子
@enduml

你也可以通过改变倒置链接来改变方向

🎉 Copied! 
@startuml
学生 -o 教室
椅子 --* 教室
@enduml

也可通过在箭头内部使用关键字， 例如left, right, up 或者 down，来改变方向

🎉 Copied! 
@startuml
foo -left-> dummyLeft
foo -right-> dummyRight
foo -up-> dummyUp
foo -down-> dummyDown
@enduml

您可以使用缩写形式来表示方向，第一个字符（例如，-d- 而不是 -down-) 或前两个字符 (-do-)。

请注意，您不应滥用此功能：Graphviz 通常无需调整即可提供良好的结果。

同时也支持 left to right direction 参数:

🎉 Copied! 
@startuml
left to right direction
foo -left-> dummyLeft
foo -right-> dummyRight
foo -up-> dummyUp
foo -down-> dummyDown
@enduml

WARNING
 This translation need to be updated. 
WARNING

“关系”类
Edit in DokuwikiEdit in AsciidocEdit in Markdown

你可以在定义了两个类之间的关系后定义一个 关系类 association class 例如:

🎉 Copied! 
@startuml
class Student {
  Name
}
Student "0..*" - "1..*" Course
(Student, Course) .. Enrollment

class Enrollment {
  drop()
  cancel()
}
@enduml

也可以用另一种方式:

🎉 Copied! 
@startuml
class Student {
  Name
}
Student "0..*" -- "1..*" Course
(Student, Course) . Enrollment

class Enrollment {
  drop()
  cancel()
}
@enduml

同级关联(Association on same classe)
Edit in DokuwikiEdit in AsciidocEdit in Markdown

🎉 Copied! 
@startuml
class 站台 {
    +名称: 字符串
}

class 通道 {
    +花费: 剩余时间
}

<> 结点

通道 . 结点
结点 - "从 0..*" 站台
结点 - "到 0..* " 站台
@enduml

[参考: Incubation: Associations]

样式参数
Edit in DokuwikiEdit in AsciidocEdit in Markdown

用skinparam改变字体和颜色。

可以在如下场景中使用：

🎉 Copied! 
@startuml

skinparam class {
BackgroundColor PaleGreen
ArrowColor SeaGreen
BorderColor SpringGreen
}
skinparam stereotypeCBackgroundColor YellowGreen

类01 "1" *-- "many" 类02 : 包含

类03 o-- 类04 : 聚合

@enduml

模型样式
Edit in DokuwikiEdit in AsciidocEdit in Markdown

你可以给模型自定义颜色和字体(You can define specific color and fonts for stereotyped classes.)

🎉 Copied! 
@startuml

skinparam class {
BackgroundColor PaleGreen
ArrowColor SeaGreen
BorderColor SpringGreen
BackgroundColor<<Foo>> Wheat
BorderColor<<Foo>> Tomato
}
skinparam stereotypeCBackgroundColor YellowGreen
skinparam stereotypeCBackgroundColor<< Foo >> DimGray

类1 <<Foo>>
类3 <<Foo>>
类1 "1" *-- "*" 类2 : 包含(contains)

类3 o-- 类4 : 聚合(aggregation)

@enduml

渐变颜色
Edit in DokuwikiEdit in AsciidocEdit in Markdown

你可以使用 # 号为类、注释等等自定义颜色。

在自定义颜色中你可以使用标准颜色的名称 或 RGB 编码，参见: Colors.

你同样可以使用下面的语法为背景色声明为渐变的颜色:

渐变的两个颜色可以使用下面的符号分割：
  • |,
  • /,
  • \,
  • -,
他们的区别在于颜色渐变的方向不同。

例如:

🎉 Copied! 
@startuml

skinparam backgroundcolor AntiqueWhite/Gold
skinparam classBackgroundColor Wheat|CornflowerBlue

class 类1 #red-green
note left of 类1 #blue\9932CC
  这是foo类的
  渐变颜色
end note

package 包1 #GreenYellow/LightGoldenRodYellow {
  class 类2
}

@enduml

辅助布局
Edit in DokuwikiEdit in AsciidocEdit in Markdown

有时候，默认布局并不完美...

你可以使用 together 关键词将某些类进行分组： 布局引擎会尝试将它们捆绑在一起（如同在一个包(package)内)

你也可以使用建立 hidden 链接的方式来强制布局

🎉 Copied! 
@startuml

class Bar1
class Bar2
together {
  class Together1
  class Together2
  class Together3
}
Together1 - Together2
Together2 - Together3
Together2 -[hidden]--> Bar1
Bar1 -[hidden]> Bar2


@enduml

拆分大文件
Edit in DokuwikiEdit in AsciidocEdit in Markdown

有些情况下，会有一些很大的图片文件。

可以用 page (hpages)x(vpages) 这个命令把生成的图片文件拆分成若干个文件。

hpages 用来表示水平方向页面数， and vpages 用来表示垂直方面页面数。

你也可以使用特定的皮肤设定来给分页添加边框（见例子）

🎉 Copied! 
@startuml
' Split into 4 pages
page 2x2
skinparam pageMargin 10
skinparam pageExternalColor gray
skinparam pageBorderColor black

class BaseClass

namespace net.dummy #DDDDDD {
    .BaseClass <|-- Person
    Meeting o-- Person

    .BaseClass <|- Meeting

}

namespace net.foo {
  net.dummy.Person  <|- Person
  .BaseClass <|-- Person

  net.dummy.Meeting o-- Person
}

BaseClass <|-- net.unused.Person
@enduml

扩展(Extends) 和 实现(implements)
Edit in DokuwikiEdit in AsciidocEdit in Markdown

他们同样使用 extends 和 implements 关键词.

🎉 Copied! 
@startuml
class ArrayList implements List
class ArrayList extends AbstractList
@enduml

方括号表示关系(连接或箭头)的样式
Edit in DokuwikiEdit in AsciidocEdit in Markdown

线样式

可以明确的使用 bold, dashed, dotted, hidden 或 plain 来表示关系, 连接或箭头:

  • 没有标签

🎉 Copied! 
@startuml
title 使用方括号([])表示的线样式（无标签版）

class foo类
class bar类
bar类1 : [bold]  
bar类2 : [dashed]
bar类3 : [dotted]
bar类4 : [hidden]
bar类5 : [plain] 

foo类 --> bar类
foo类 -[bold]-> bar类1
foo类 -[dashed]-> bar类2
foo类 -[dotted]-> bar类3
foo类 -[hidden]-> bar类4
foo类 -[plain]-> bar类5
@enduml

  • 有标签

🎉 Copied! 
@startuml
title 使用方括号([])表示的线样式（有标签版）

class foo类
class bar类
bar类1 : [bold]  
bar类2 : [dashed]
bar类3 : [dotted]
bar类4 : [hidden]
bar类5 : [plain] 

foo类 --> bar类          : ∅
foo类 -[bold]-> bar类1   : [bold]
foo类 -[dashed]-> bar类2 : [dashed]
foo类 -[dotted]-> bar类3 : [dotted]
foo类 -[hidden]-> bar类4 : [hidden]
foo类 -[plain]-> bar类5  : [plain]
@enduml

[改编自 QA-4181]

线颜色

🎉 Copied! 
@startuml
title 使用方括号([])表示的线颜色
class foo类
class bar类
bar类1 : [#red]
bar类2 : [#green]
bar类3 : [#blue]

foo类 --> bar类
foo类 -[#red]-> bar类1     : [#red]
foo类 -[#green]-> bar类2   : [#green]
foo类 -[#blue]-> bar类3    : [#blue]
'foo类 -[#blue;#yellow;#green]-> bar类4
@enduml

线宽度

🎉 Copied! 
@startuml
title 使用方括号([])表示的线宽度
class foo类
class bar类
bar类1 : [thickness=1]
bar类2 : [thickness=2]
bar类3 : [thickness=4]
bar类4 : [thickness=8]
bar类5 : [thickness=16]

foo类 --> bar类                 : ∅
foo类 -[thickness=1]-> bar类1   : [1]
foo类 -[thickness=2]-> bar类2   : [2]
foo类 -[thickness=4]-> bar类3   : [4]
foo类 -[thickness=8]-> bar类4   : [8]
foo类 -[thickness=16]-> bar类5  : [16]

@enduml

[参考: QA-4949]

混合样式

🎉 Copied! 
@startuml
title 使用方括号([])表示的线混合样式
class foo类
class bar类
bar类1 : [#red,thickness=1]
bar类2 : [#red,dashed,thickness=2]
bar类3 : [#green,dashed,thickness=4]
bar类4 : [#blue,dotted,thickness=8]
bar类5 : [#blue,plain,thickness=16]

foo类 --> bar类                             : ∅
foo类 -[#red,thickness=1]-> bar类1          : [#red,1]
foo类 -[#red,dashed,thickness=2]-> bar类2   : [#red,dashed,2]
foo类 -[#green,dashed,thickness=4]-> bar类3 : [#green,dashed,4]
foo类 -[#blue,dotted,thickness=8]-> bar类4  : [blue,dotted,8]
foo类 -[#blue,plain,thickness=16]-> bar类5  : [blue,plain,16]
@enduml

改变关系(线和箭头)的颜色和样式(单行样式)
Edit in DokuwikiEdit in AsciidocEdit in Markdown

你可以改变表示关系的线和箭头的颜色或样式，使用下面的单行样式格式：

  • #color;line.[bold|dashed|dotted];text:color

🎉 Copied! 
@startuml
class foo类
foo类 --> bar类 : 默认
foo类 --> bar类1 #line:red;line.bold;text:red  : 红色粗线
foo类 --> bar类2 #green;line.dashed;text:green : 绿色断线
foo类 --> bar类3 #blue;line.dotted;text:blue   : 蓝色点线
@enduml

[See similar feature on deployment]

改变类颜色和样式 (单行样式)
Edit in DokuwikiEdit in AsciidocEdit in Markdown

你可以改变定义类的 颜色 或样式， 通过下面两种指定格式:

  • #color ##[style]color

第一个颜色(#color)表示背景色，然后第二个表示线的样式和颜色(##[style]color)

🎉 Copied! 
@startuml
abstract   抽象类
annotation 注解     #pink ##[bold]red
class      类      #palegreen ##[dashed]green
interface  接口    #aliceblue ##[dotted]blue
@enduml

[参考: QA-1487]

  • #[color|back:color];header:color;line:color;line.[bold|dashed|dotted];text:color

🎉 Copied! 
@startuml
abstract   抽象类
annotation 注解     #pink;line:red;line.bold;text:red
class      类      #palegreen;line:green;line.dashed;text:green
interface  接口    #aliceblue;line:blue;line.dotted;text:blue
@enduml

第一个原始示例:

🎉 Copied! 
@startuml
class bar类 #line:green;back:lightblue
class bar类2 #lightblue;line:green

class Foo类1 #back:red;line:00FFFF
class Foo类Dashed #line.dashed:blue
class Foo类Dotted #line.dotted:blue
class Foo类Bold #line.bold
class Demo类1 #back:lightgreen|yellow;header:blue/red
@enduml

[参考. QA-3770]

类成员的箭头方向(Arrows from/to class members)
Edit in DokuwikiEdit in AsciidocEdit in Markdown

🎉 Copied! 
@startuml
class Foo类 {
+ 字段1
+ 字段2
}

class Bar类 {
+ 字段3
+ 字段4
}

Foo类::字段1 --> Bar类::字段3 : foo
Foo类::字段2 --> Bar类::字段4 : bar
@enduml

[参考: QA-3636]

🎉 Copied! 
@startuml
left to right direction

class User类 {
  id : INTEGER
  ..
  其他id : INTEGER
}

class Email类 {
  id : INTEGER
  ..
  用户_id : INTEGER
  地址 : STRING
}

User类::id *-- Email类::用户_id
@enduml

[参考: QA-5261]

分组继承关系(Grouping inheritance arrow heads)
Edit in DokuwikiEdit in AsciidocEdit in Markdown

你可以合并所有的箭头，使用 skinparam groupInheritance, 用阈值(第几组)作为参数。

阈值 1 (没有分组)

🎉 Copied! 
@startuml
skinparam groupInheritance 1

A1 <|-- B1

A2 <|-- B2
A2 <|-- C2

A3 <|-- B3
A3 <|-- C3
A3 <|-- D3

A4 <|-- B4
A4 <|-- C4
A4 <|-- D4
A4 <|-- E4
@enduml

阈值 2 (从第2组开始分组)

🎉 Copied! 
@startuml
skinparam groupInheritance 2

A1 <|-- B1

A2 <|-- B2
A2 <|-- C2

A3 <|-- B3
A3 <|-- C3
A3 <|-- D3

A4 <|-- B4
A4 <|-- C4
A4 <|-- D4
A4 <|-- E4
@enduml

阈值 3 (从第3组开始分组)

🎉 Copied! 
@startuml
skinparam groupInheritance 3

A1 <|-- B1

A2 <|-- B2
A2 <|-- C2

A3 <|-- B3
A3 <|-- C3
A3 <|-- D3

A4 <|-- B4
A4 <|-- C4
A4 <|-- D4
A4 <|-- E4
@enduml

阈值 4 (从第4组开始分组)

🎉 Copied! 
@startuml
skinparam groupInheritance 4

A1 <|-- B1

A2 <|-- B2
A2 <|-- C2

A3 <|-- B3
A3 <|-- C3
A3 <|-- D3

A4 <|-- B4
A4 <|-- C4
A4 <|-- D4
A4 <|-- E4
@enduml

[参考: QA-3193, 和 缺陷 QA-13532]