PlantUMLLanguage specificationSequence Diagram

         

Edit in DokuwikiEdit in AsciidocEdit in Markdown 序列图 Edit in DokuwikiEdit in AsciidocEdit in Markdown 基本的例子 序列-> 用于绘制两个 参与者之间的信息。 参与者不必明确声明。 要有一个点状的箭头，就用--> 也可以用<- 和<-- 。 这不会改变绘图，但可能提高可读性。 注意，这只适用于顺序图，其他图的规则不同。 🎉 Copied! @startuml Alice -> Bob: Authentication Request Bob --> Alice: Authentication Response Alice -> Bob: Another authentication Request Alice <-- Bob: Another authentication Response @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 声明参与者 如果使用关键字participant 来声明参与者，就可以对该参与者进行更多的控制。 声明的顺序将是（默认的）显示顺序。 使用这些其他的关键字来声明参与者，将改变参与者的表示形状。 actor（角色） boundary（边界） control（控制） entity（实体） database（数据库） collections（集合） queue（队列） 🎉 Copied! @startuml participant Participant as Foo actor Actor as Foo1 boundary Boundary as Foo2 control Control as Foo3 entity Entity as Foo4 database Database as Foo5 collections Collections as Foo6 queue Queue as Foo7 Foo -> Foo1 : To actor Foo -> Foo2 : To boundary Foo -> Foo3 : To control Foo -> Foo4 : To entity Foo -> Foo5 : To database Foo -> Foo6 : To collections Foo -> Foo7: To queue @enduml 使用as 关键字重命名参与者。 你也可以改变 演员或参与者的背景颜色。 🎉 Copied! @startuml actor Bob #red ' The only difference between actor 'and participant is the drawing participant Alice participant "I have a really\nlong name" as L #99FF99 /' You can also declare: participant L as "I have a really\nlong name" #99FF99 '/ Alice->Bob: Authentication Request Bob->Alice: Authentication Response Bob->L: Log transaction @enduml 您可以使用order 关键字来定制参与者的显示顺序。 🎉 Copied! @startuml participant Last order 30 participant Middle order 20 participant First order 10 @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 多行定义参与者 你可以对参与者使用多行定义。 🎉 Copied! @startuml participant Participant [ =Title ---- ""打算"" ] participant Bob Participant -> Bob @enduml [Ref. QA-15232] Edit in DokuwikiEdit in AsciidocEdit in Markdown 在参与者中使用非字母 你可以使用引号来定义参与者。 而且你可以使用as 关键字来给这些参与者一个别名。 🎉 Copied! @startuml Alice -> "Bob()" : Hello "Bob()" -> "This is very\nlong" as Long ' You can also declare: ' "Bob()" -> Long as "This is very\nlong" Long --> "Bob()" : ok @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 给自己发消息 参与者可以给自己发信息， 消息文字可以用\n来换行。 🎉 Copied! @startuml Alice -> Alice: This is a signal to self.\nIt also demonstrates\nmultiline \ntext @enduml 🎉 Copied! @startuml Alice <- Alice: This is a signal to self.\nIt also demonstrates\nmultiline \ntext @enduml *[Ref. [QA-1361](https://forum.plantuml.net/1361)]* Edit in DokuwikiEdit in AsciidocEdit in Markdown 文本对齐 箭头上的文本对齐可以用skinparam sequenceMessageAlign，后接参数left,right或center。 你也可以使用direction或reverseDirection来根据箭头的方向对齐文本。更多细节可参考skinparam。 🎉 Copied! @startuml skinparam sequenceMessageAlign right Bob -> Alice : Request Alice -> Bob : Response @enduml 让响应信息显示在箭头下面 你可以使用skinparam responseMessageBelowArrow true命令，让响应信息显示在箭头下面。 🎉 Copied! @startuml skinparam responseMessageBelowArrow true Bob -> Alice : hello Alice -> Bob : ok @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 改变箭头样式 您可以通过以下几种方式改变箭头样式： 添加最后的x 表示丢失的信息 使用\ 或/ 而不是< 或> 只拥有箭头的底部或顶部部分 重复箭头头（例如>> 或// ）头，拥有一个薄的图纸 使用-- 而不是- 拥有一个点状箭头 在箭头头添加最后的 "o" 使用双向的箭头<-> 🎉 Copied! @startuml Bob ->x Alice Bob -> Alice Bob ->> Alice Bob -\ Alice Bob \\- Alice Bob //-- Alice Bob ->o Alice Bob o\\-- Alice Bob <-> Alice Bob <->o Alice @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 修改箭头颜色 你可以用以下记号修改箭头的颜色： 🎉 Copied! @startuml Bob -[#red]> Alice : hello Alice -[#0000FF]->Bob : ok @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 对消息序列编号 关键字 autonumber 用于自动对消息编号。 🎉 Copied! @startuml autonumber Bob -> Alice : Authentication Request Bob <- Alice : Authentication Response @enduml 语句 autonumber //start// 用于指定编号的初始值，而 autonumber //start// //increment// 可以同时指定编号的初始值和每次增加的值。 🎉 Copied! @startuml autonumber Bob -> Alice : Authentication Request Bob <- Alice : Authentication Response autonumber 15 Bob -> Alice : Another authentication Request Bob <- Alice : Another authentication Response autonumber 40 10 Bob -> Alice : Yet another authentication Request Bob <- Alice : Yet another authentication Response @enduml 你可以在双引号内指定编号的格式。 格式是由 Java 的DecimalFormat类实现的： (0 表示数字；# 也表示数字，但默认为0)。 你也可以用 HTML 标签来制定格式。 🎉 Copied! @startuml autonumber "<b>[000]" Bob -> Alice : Authentication Request Bob <- Alice : Authentication Response autonumber 15 "<b>(<u>##</u>)" Bob -> Alice : Another authentication Request Bob <- Alice : Another authentication Response autonumber 40 10 "<font color=red><b>Message 0 " Bob -> Alice : Yet another authentication Request Bob <- Alice : Yet another authentication Response @enduml 你还可以用语句 autonumber stop 和 autonumber resume //increment// //format// 来表示暂停或继续使用自动编号。 🎉 Copied! @startuml autonumber 10 10 "<b>[000]" Bob -> Alice : Authentication Request Bob <- Alice : Authentication Response autonumber stop Bob -> Alice : dummy autonumber resume "<font color=red><b>Message 0 " Bob -> Alice : Yet another authentication Request Bob <- Alice : Yet another authentication Response autonumber stop Bob -> Alice : dummy autonumber resume 1 "<font color=blue><b>Message 0 " Bob -> Alice : Yet another authentication Request Bob <- Alice : Yet another authentication Response @enduml 你也可以使用一个2或3位的序列，中间采用一种或几种分隔符，如.,;,,,:。例如：1.1.1 或1.1:1 。 最后一位数字会自动递增。 要增加第一个数字，请使用：autonumber inc A 。要增加第二位数字，请使用：autonumber inc B 。 🎉 Copied! @startuml autonumber 1.1.1 Alice -> Bob: Authentication request Bob --> Alice: Response autonumber inc A 'Now we have 2.1.1 Alice -> Bob: Another authentication request Bob --> Alice: Response autonumber inc B 'Now we have 2.2.1 Alice -> Bob: Another authentication request Bob --> Alice: Response autonumber inc A 'Now we have 3.1.1 Alice -> Bob: Another authentication request autonumber inc B 'Now we have 3.2.1 Bob --> Alice: Response @enduml 你也可以用autonumber 的值，带有%autonumber% 变量。 🎉 Copied! @startuml autonumber 10 Alice -> Bob note right the <U+0025>autonumber<U+0025> works everywhere. Here, its value is ** %autonumber% ** end note Bob --> Alice: //This is the response %autonumber%// @enduml [Ref.QA-7119] Edit in DokuwikiEdit in AsciidocEdit in Markdown 页面标题、页眉和页脚 title 关键字用于为页面添加标题。 页面可以使用header 和footer 显示页眉和页脚。 🎉 Copied! @startuml header Page Header footer Page %page% of %lastpage% title Example Title Alice -> Bob : message 1 Alice -> Bob : message 2 @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 分割示意图 关键字 newpage 用于把一张图分割成多张。 在 newpage 之后添加文字，作为新的示意图的标题。 这样就能很方便地在 Word 中将长图分几页打印。 🎉 Copied! @startuml Alice -> Bob : message 1 Alice -> Bob : message 2 newpage Alice -> Bob : message 3 Alice -> Bob : message 4 newpage A title for the\nlast page Alice -> Bob : message 5 Alice -> Bob : message 6 @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 组合消息 我们可以通过以下关键词来组合消息： alt/else opt loop par break critical group, 后面紧跟着消息内容 可以在标头(header)添加需要显示的文字(对于group关键字，参看下一章节 '次级分组标签')。 关键词 end 用来结束分组。 注意，分组可以嵌套使用。 🎉 Copied! @startuml Alice -> Bob: 认证请求 alt 成功情况 Bob -> Alice: 认证接受 else 某种失败情况 Bob -> Alice: 认证失败 group 我自己的标签 Alice -> Log : 开始记录攻击日志 loop 1000次 Alice -> Bob: DNS 攻击 end Alice -> Log : 结束记录攻击日志 end else 另一种失败 Bob -> Alice: 请重复 end @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 次级分组标签 对于group而言，在标头处的[和]之间可以显示次级文本或标签。 🎉 Copied! @startuml Alice -> Bob: 认证请求 Bob -> Alice: 认证失败 group 我自己的标签 [我自己的标签2] Alice -> Log : 开始记录攻击日志 loop 1000次 Alice -> Bob: DNS攻击 end Alice -> Log : 结束记录攻击日志 end @enduml [参看 QA-2503] Edit in DokuwikiEdit in AsciidocEdit in Markdown 注释信息 可以使用note left 或note right 关键字在信息后面加上注释。 你可以使用end note 关键字有一个多行注释。 🎉 Copied! @startuml Alice->Bob : hello note left: this is a first note Bob->Alice : ok note right: this is another note Bob->Bob : I am thinking note left a note can also be defined on several lines end note @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 其他的注释信息方式 可以使用note left of，note right of或note over在节点(participant)的相对位置放置注释。 还可以通过修改背景色来高亮显示注释。 以及使用关键字end note来添加多行注释。 🎉 Copied! @startuml participant Alice participant Bob note left of Alice #aqua This is displayed left of Alice. end note note right of Alice: This is displayed right of Alice. note over Alice: This is displayed over Alice. note over Alice, Bob #FFAAAA: This is displayed\n over Bob and Alice. note over Bob, Alice This is yet another example of a long note. end note @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 改变备注框的形状 [hnote和rnote] 你可以使用 hnote 和 rnote 这两个关键字来修改备注框的形状： hnote代表六边形（hexagonal）的备注框； rnote代表正方形（rectangle）的备注框。 🎉 Copied! @startuml caller -> server : conReq hnote over caller : 空闲 caller <- server : conConf rnote over server "r"是正方形 "h"是六边形 endrnote rnote over server 多 行 文本 endrnote hnote over caller 多 行 文本 endhnote @enduml [参见 QA-1765] Edit in DokuwikiEdit in AsciidocEdit in Markdown 在多个参与者添加备注 [across] 你可以之直接在所有参与者之间添加备注，格式是： note across: 备注描述 🎉 Copied! @startuml Alice->Bob:m1 Bob->Charlie:m2 note over Alice, Charlie: 创建跨越所有参与者的备注的旧方法：\n ""note over //FirstPart, LastPart//"". note across: 新方法：\n""note across"" Bob->Alice hnote across: 跨越所有参与者的备注。 @enduml [参见 QA-9738] Edit in DokuwikiEdit in AsciidocEdit in Markdown 在同一级对齐多个备注 [/] 使用/可以在同一级对齐多个备注： 没有/（默认情况下，备注不是对齐的。） 🎉 Copied! @startuml note over Alice : Alice的初始状态 note over Bob : Bob的初始状态 Bob -> Alice : hello @enduml with /(the notes are aligned) 🎉 Copied! @startuml note over Alice : Alice的初始状态 / note over Bob : Bob的初始状态 Bob -> Alice : hello @enduml [参见 QA-354] Edit in DokuwikiEdit in AsciidocEdit in Markdown Creole和HTML 可以使用creole格式。 🎉 Copied! @startuml participant Alice participant "The **Famous** Bob" as Bob Alice -> Bob : hello --there-- ... Some ~~long delay~~ ... Bob -> Alice : ok note left This is **bold** This is //italics// This is ""monospaced"" This is --stroked-- This is __underlined__ This is ~~waved~~ end note Alice -> Bob : A //well formatted// message note right of Alice This is <back:cadetblue><size:18>displayed</size></back> __left of__ Alice. end note note left of Bob <u:red>This</u> is <color #118888>displayed</color> **<color purple>left of</color> <s:red>Alice</strike> Bob**. end note note over Alice, Bob <w:#FF33FF>This is hosted</w> by <img sourceforge.jpg> end note @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 分隔符 你可以通过使用==关键词来将你的图表分割成多个逻辑步骤。 🎉 Copied! @startuml == 初始化 == Alice -> Bob: 认证请求 Bob --> Alice: 认证响应 == 重复 == Alice -> Bob: 认证请求 Alice <-- Bob: 认证响应 @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 引用 你可以在图中通过使用ref over关键词来实现引用 🎉 Copied! @startuml participant Alice actor Bob ref over Alice, Bob : init Alice -> Bob : hello ref over Bob This can be on several lines end ref @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 延迟 你可以使用...来表示延迟，并且还可以给延迟添加注释。 🎉 Copied! @startuml Alice -> Bob: 认证请求 ... Bob --> Alice: 认证响应 ...5分钟后... Bob --> Alice: 再见！ @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 文本换行 你可以通过手动在文本中添加\n使长文本换行。 或者使用maxMessageSize设置（此方式暂不支持中文换行）： 🎉 Copied! @startuml skinparam maxMessageSize 50 participant a participant b a -> b :这\n一条\n是\n手动换行 a -> b :this is a very long message on several words @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 空间 你可以使用|||来增加空间。 还可以使用数字指定增加的像素的数量。 🎉 Copied! @startuml Alice -> Bob: message 1 Bob --> Alice: ok ||| Alice -> Bob: message 2 Bob --> Alice: ok ||45|| Alice -> Bob: message 3 Bob --> Alice: ok @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 生命线的激活与撤销 关键字activate和deactivate用来表示参与者的生命活动。 一旦参与者被激活，它的生命线就会显示出来。 activate和deactivate适用于以上情形。 destroy表示一个参与者的生命线的终结。 🎉 Copied! @startuml participant User User -> A: DoWork activate A A -> B: << createRequest >> activate B B -> C: DoWork activate C C --> B: WorkDone destroy C B --> A: RequestCreated deactivate B A -> User: Done deactivate A @enduml 还可以使用嵌套的生命线，并且运行给生命线添加颜色。 🎉 Copied! @startuml participant User User -> A: DoWork activate A #FFBBBB A -> A: Internal call activate A #DarkSalmon A -> B: << createRequest >> activate B B --> A: RequestCreated deactivate B deactivate A A -> User: Done deactivate A @enduml 也可以使用自动激活关键字（autoactivate），这需要与return关键字配合： 🎉 Copied! @startuml autoactivate on alice -> bob : hello bob -> bob : self call bill -> bob #005500 : hello from thread 2 bob -> george ** : create return done in thread 2 return rc bob -> george !! : delete return success @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 返回 新命令return可以用于生成一个带有可选文本标签的返回信息。返回的点是导致最近一次激活生命线的点。语法是简单的返回标签，其中标签（如果提供）可以是传统信息中可以接受的任何字符串。 🎉 Copied! @startuml Bob -> Alice : hello activate Alice Alice -> Alice : some action return bye @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 创建参与者 你可以把关键字create放在第一次接收到消息之前，以强调本次消息实际上是在创建新的对象。 🎉 Copied! @startuml Bob -> Alice : hello create Other Alice -> Other : new create control String Alice -> String note right : You can also put notes! Alice --> Bob : ok @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 激活、撤销和创建的快捷语法。 在指定目标参与者后，可以立即使用以下语法： ++ 激活目标（可选择在后面加上#color） -- 撤销激活源 ** 创建目标实例 !! 摧毁目标实例 🎉 Copied! @startuml alice -> bob ++ : hello bob -> bob ++ : self call bob -> bib ++ #005500 : hello bob -> george ** : create return done return rc bob -> george !! : delete return success @enduml 然后你就可以在一行上同时激活和撤销： 🎉 Copied! @startuml alice -> bob ++ : hello1 bob -> charlie --++ : hello2 charlie --> alice -- : ok @enduml 🎉 Copied! @startuml @startuml alice -> bob --++ #gold: hello bob -> alice --++ #gold: you too alice -> bob --: step1 alice -> bob : step2 @enduml @enduml [参见 QA-4834, QA-9573 和 QA-13234] Edit in DokuwikiEdit in AsciidocEdit in Markdown 进入和发出消息 如果只想关注部分图示，你可以使用进入和发出箭头。 使用方括号[和]表示图示的左、右两侧。 🎉 Copied! @startuml [-> A: DoWork activate A A -> A: Internal call activate A A ->] : << createRequest >> A<--] : RequestCreated deactivate A [<- A: Done deactivate A @enduml 还可以使用下面的语法: 🎉 Copied! @startuml participant Alice participant Bob #lightblue Alice -> Bob Bob -> Carol ... [-> Bob [o-> Bob [o->o Bob [x-> Bob ... [<- Bob [x<- Bob ... Bob ->] Bob ->o] Bob o->o] Bob ->x] ... Bob <-] Bob x<-] @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 缩短的进入信息与发出信息箭头 使用?来显示缩短的箭头。 🎉 Copied! @startuml ?-> Alice : ""?->""\n**short** to actor1 [-> Alice : ""[->""\n**from start** to actor1 [-> Bob : ""[->""\n**from start** to actor2 ?-> Bob : ""?->""\n**short** to actor2 Alice ->] : ""->]""\nfrom actor1 **to end** Alice ->? : ""->?""\n**short** from actor1 Alice -> Bob : ""->"" \nfrom actor1 to actor2 @enduml [参见 QA-310] Edit in DokuwikiEdit in AsciidocEdit in Markdown 锚点和持续时间 使用teoz在图表中添加锚点，从而指定持续时间。 🎉 Copied! @startuml !pragma teoz true {start} Alice -> Bob : start doing things during duration Bob -> Max : something Max -> Bob : something else {end} Bob -> Alice : finish {start} <-> {end} : some time @enduml You can use the -Pcommand-line option to specify the pragma: java -jar plantuml.jar -Pteoz=true [Ref. issue-582] WARNING  This translation need to be updated.  WARNING Edit in DokuwikiEdit in AsciidocEdit in Markdown 构造类型和圈点 可以使用<<和>>给参与者添加构造类型。 在构造类型中，你可以使用(X,color)格式的语法添加一个圆圈圈起来的字符。 🎉 Copied! @startuml participant "Famous Bob" as Bob << Generated >> participant Alice << (C,#ADD1B2) Testable >> Bob->Alice: First message @enduml 默认使用 guillemet 字符来显示构造类型。 你可以使用外观参数 guillemet 来修改显示行为。 🎉 Copied! @startuml skinparam guillemet false participant "Famous Bob" as Bob << Generated >> participant Alice << (C,#ADD1B2) Testable >> Bob->Alice: First message @enduml 🎉 Copied! @startuml participant Bob << (C,#ADD1B2) >> participant Alice << (C,#ADD1B2) >> Bob->Alice: First message @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 更多标题信息 你可以在标题中使用creole格式。 🎉 Copied! @startuml title __Simple__ **communication** example Alice -> Bob: Authentication Request Bob -> Alice: Authentication Response @enduml 在标题描述中使用\n表示换行。 🎉 Copied! @startuml title __Simple__ communication example\non several lines Alice -> Bob: Authentication Request Bob -> Alice: Authentication Response @enduml 还可以使用关键字title和end title定义多行标题。 🎉 Copied! @startuml title <u>Simple</u> communication example on <i>several</i> lines and using <font color=red>html</font> This is hosted by <img:sourceforge.jpg> end title Alice -> Bob: Authentication Request Bob -> Alice: Authentication Response @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 包裹参与者 可以使用box和end box画一个盒子将参与者包裹起来。 还可以在box关键字之后添加标题或者背景颜色。 🎉 Copied! @startuml box "Internal Service" #LightBlue participant Bob participant Alice end box participant Other Bob -> Alice : hello Alice -> Other : hello @enduml WARNING  This translation need to be updated.  WARNING Edit in DokuwikiEdit in AsciidocEdit in Markdown 移除脚注 使用hide footbox关键字移除脚注。 🎉 Copied! @startuml hide footbox title Footer removed Alice -> Bob: Authentication Request Bob --> Alice: Authentication Response @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 外观参数(skinparam) 用skinparam改变字体和颜色。 可以在如下场景中使用： 在图示的定义中， 在引入的文件中， 在命令行或者ANT任务提供的配置文件中。 你也可以修改其他渲染元素，如以下示例： 🎉 Copied! @startuml skinparam sequenceArrowThickness 2 skinparam roundcorner 20 skinparam maxmessagesize 60 skinparam sequenceParticipant underline actor User participant "First Class" as A participant "Second Class" as B participant "Last Class" as C User -> A: DoWork activate A A -> B: Create Request activate B B -> C: DoWork activate C C --> B: WorkDone destroy C B --> A: Request Created deactivate B A --> User: Done deactivate A @enduml 🎉 Copied! @startuml skinparam backgroundColor #EEEBDC skinparam handwritten true skinparam sequence { ArrowColor DeepSkyBlue ActorBorderColor DeepSkyBlue LifeLineBorderColor blue LifeLineBackgroundColor #A9DCDF ParticipantBorderColor DeepSkyBlue ParticipantBackgroundColor DodgerBlue ParticipantFontName Impact ParticipantFontSize 17 ParticipantFontColor #A9DCDF ActorBackgroundColor aqua ActorFontColor DeepSkyBlue ActorFontSize 17 ActorFontName Aapex } actor User participant "First Class" as A participant "Second Class" as B participant "Last Class" as C User -> A: DoWork activate A A -> B: Create Request activate B B -> C: DoWork activate C C --> B: WorkDone destroy C B --> A: Request Created deactivate B A --> User: Done deactivate A @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 填充区设置 可以设定填充区的参数配置。 🎉 Copied! @startuml skinparam ParticipantPadding 20 skinparam BoxPadding 10 box "Foo1" participant Alice1 participant Alice2 end box box "Foo2" participant Bob1 participant Bob2 end box Alice1 -> Bob1 : hello Alice1 -> Out : out @enduml Edit in DokuwikiEdit in AsciidocEdit in Markdown 附录：箭头类型大全 普通箭头 🎉 Copied! @startuml participant Alice as a participant Bob as b a -> b : ""-> "" a ->> b : ""->> "" a -\ b : ""-\ "" a -\\ b : ""-\\\\"" a -/ b : ""-/ "" a -// b : ""-// "" a ->x b : ""->x "" a x-> b : ""x-> "" a o-> b : ""o-> "" a ->o b : ""->o "" a o->o b : ""o->o "" a <-> b : ""<-> "" a o<->o b : ""o<->o"" a x<->x b : ""x<->x"" a ->>o b : ""->>o "" a -\o b : ""-\o "" a -\\o b : ""-\\\\o"" a -/o b : ""-/o "" a -//o b : ""-//o "" a x->o b : ""x->o "" @enduml 进入信息和发出信息（使用'[', ']'） 进入信息（使用'['） 🎉 Copied! @startuml participant Alice as a participant Bob as b [-> b : ""[-> "" [->> b : ""[->> "" [-\ b : ""[-\ "" [-\\ b : ""[-\\\\"" [-/ b : ""[-/ "" [-// b : ""[-// "" [->x b : ""[->x "" [x-> b : ""[x-> "" [o-> b : ""[o-> "" [->o b : ""[->o "" [o->o b : ""[o->o "" [<-> b : ""[<-> "" [o<->o b : ""[o<->o"" [x<->x b : ""[x<->x"" [->>o b : ""[->>o "" [-\o b : ""[-\o "" [-\\o b : ""[-\\\\o"" [-/o b : ""[-/o "" [-//o b : ""[-//o "" [x->o b : ""[x->o "" @enduml 发出信息（使用']'） 🎉 Copied! @startuml participant Alice as a participant Bob as b a ->] : ""->] "" a ->>] : ""->>] "" a -\] : ""-\] "" a -\\] : ""-\\\\]"" a -/] : ""-/] "" a -//] : ""-//] "" a ->x] : ""->x] "" a x->] : ""x->] "" a o->] : ""o->] "" a ->o] : ""->o] "" a o->o] : ""o->o] "" a <->] : ""<->] "" a o<->o] : ""o<->o]"" a x<->x] : ""x<->x]"" a ->>o] : ""->>o] "" a -\o] : ""-\o] "" a -\\o] : ""-\\\\o]"" a -/o] : ""-/o] "" a -//o] : ""-//o] "" a x->o] : ""x->o] "" @enduml 短进入信息和短发出信息（使用'?'） 短进入信息（使用'?'） 🎉 Copied! @startuml participant Alice as a participant Bob as b a -> b : //Long long label// ?-> b : ""?-> "" ?->> b : ""?->> "" ?-\ b : ""?-\ "" ?-\\ b : ""?-\\\\"" ?-/ b : ""?-/ "" ?-// b : ""?-// "" ?->x b : ""?->x "" ?x-> b : ""?x-> "" ?o-> b : ""?o-> "" ?->o b : ""?->o "" ?o->o b : ""?o->o "" ?<-> b : ""?<-> "" ?o<->o b : ""?o<->o"" ?x<->x b : ""?x<->x"" ?->>o b : ""?->>o "" ?-\o b : ""?-\o "" ?-\\o b : ""?-\\\\o "" ?-/o b : ""?-/o "" ?-//o b : ""?-//o "" ?x->o b : ""?x->o "" @enduml 短发出信息（使用'?'） 🎉 Copied! @startuml participant Alice as a participant Bob as b a -> b : //Long long label// a ->? : ""->? "" a ->>? : ""->>? "" a -\? : ""-\? "" a -\\? : ""-\\\\?"" a -/? : ""-/? "" a -//? : ""-//? "" a ->x? : ""->x? "" a x->? : ""x->? "" a o->? : ""o->? "" a ->o? : ""->o? "" a o->o? : ""o->o? "" a <->? : ""<->? "" a o<->o? : ""o<->o?"" a x<->x? : ""x<->x?"" a ->>o? : ""->>o? "" a -\o? : ""-\o? "" a -\\o? : ""-\\\\o?"" a -/o? : ""-/o? "" a -//o? : ""-//o? "" a x->o? : ""x->o? "" @enduml WARNING  This translation need to be updated.  WARNING Edit in DokuwikiEdit in AsciidocEdit in Markdown 特定外观参数 默认情况下 🎉 Copied! @startuml Bob -> Alice : hello Alice -> Bob : ok @enduml 生命线策略 nosolid 虚线 （默认情况） 🎉 Copied! @startuml skinparam lifelineStrategy nosolid Bob -> Alice : hello Alice -> Bob : ok @enduml [参见 QA-9016] solid 实线 在时序图中使用实线生命线：skinparam lifelineStrategy solid 🎉 Copied! @startuml skinparam lifelineStrategy solid Bob -> Alice : hello Alice -> Bob : ok @enduml [参见 QA-2794] style strictuml 为了符合严格UML的标准（线头的形状必须是三角形，而不能是箭头形），你可以使用： skinparam style strictuml 🎉 Copied! @startuml skinparam style strictuml Bob -> Alice : hello Alice -> Bob : ok @enduml [参见 QA-1047] Edit in DokuwikiEdit in AsciidocEdit in Markdown 隐藏孤立参与者 默认情况下会显示所有参与者。 🎉 Copied! @startuml participant Alice participant Bob participant Carol Alice -> Bob : hello @enduml 可以使用hide unlinked命令来隐藏未被链接到的参与者。 🎉 Copied! @startuml hide unlinked participant Alice participant Bob participant Carol Alice -> Bob : hello @enduml [Ref. QA-4247] Edit in DokuwikiEdit in AsciidocEdit in Markdown 给分组信息着色 可以给分组信息color[着色]。 🎉 Copied! @startuml Alice -> Bob: Authentication Request alt#Gold #LightBlue Successful case Bob -> Alice: Authentication Accepted else #Pink Failure Bob -> Alice: Authentication Rejected end @enduml [Ref.QA-4750andQA-6410] Edit in DokuwikiEdit in AsciidocEdit in Markdown Mainframe 🎉 Copied! @startuml mainframe This is a **mainframe** Alice->Bob : Hello @enduml [Ref. QA-4019 and Issue#148] Edit in DokuwikiEdit in AsciidocEdit in Markdown Slanted or odd arrows You can use the (nn) option (before or after arrow) to make the arrows slanted, where nn is the number of shift pixels. [Available only after v1.2022.6beta+] 🎉 Copied! @startuml A ->(10) B: text 10 B ->(10) A: text 10 A ->(10) B: text 10 A (10)<- B: text 10 @enduml 🎉 Copied! @startuml A ->(40) B++: Rq B -->(20) A--: Rs @enduml [Ref. QA-14145] 🎉 Copied! @startuml !pragma teoz true A ->(50) C: Starts\nwhen 'B' sends & B ->(25) C: \nBut B's message\n arrives before A's @enduml [Ref. QA-6684] 🎉 Copied! @startuml !pragma teoz true S1 ->(30) S2: msg 1\n & S2 ->(30) S1: msg 2 note left S1: msg\nS2 to S1 & note right S2: msg\nS1 to S2 @enduml [Ref. QA-1072]

基本的例子 声明参与者 多行定义参与者 在参与者中使用非字母 给自己发消息 文本对齐 改变箭头样式 修改箭头颜色 对消息序列编号 页面标题、页眉和页脚 分割示意图 组合消息 次级分组标签 注释信息 其他的注释信息方式 改变备注框的形状 [hnote和rnote] 在多个参与者添加备注 [across] 在同一级对齐多个备注 [/] Creole和HTML 分隔符 引用 延迟 文本换行 空间 生命线的激活与撤销 返回 创建参与者 激活、撤销和创建的快捷语法。 进入和发出消息 缩短的进入信息与发出信息箭头 锚点和持续时间 构造类型和圈点 更多标题信息 包裹参与者 移除脚注 外观参数(skinparam) 填充区设置 附录：箭头类型大全 特定外观参数 隐藏孤立参与者 给分组信息着色 Mainframe Slanted or odd arrows