Skip to main content
Behavior · sequenceDiagram

Sequence Diagram(顺序图)

时间是有方向的:参与者是列,消息是行,从上往下一步步发生。这套坐标不走 Sugiyama,而是独立的时间轴布局(layout/sequence.ts)。

Mermaid · sequenceDiagram
正在加载 moqi-uml 引擎…

右栏是时间线画布:列顺序 = 声明顺序,它是文档的投影而不是另一个模型(ADR-21)。

为什么单独一套布局

顺序图有时间轴——从上到下就是时间推进,消息线是水平的,不是 DAG 的有向边。所以它不复用 Sugiyama,而是:

  1. parseSequenceDiagram 产出一条线性的 SequenceDiagram(参与者 + 按序的 message/note/fragment);
  2. layoutSequence 算列宽、行高、activation 跨度、fragment 包围盒;
  3. 两个渲染目标消费同一份 SequenceLayout——emitSequenceSvg 出静态 SVG,TimelineCanvas 出可交互画布。

已支持

语法效果
participant API as Order API声明列,as 后面是显示名
actor User小人图形
->> / -->>同步消息 / 返回消息(实线 / 虚线)
Note over A,B: …跨列注解条
alt / else / end分支框(opt / loop / par / critical 同理)
box … end分组框,圈住若干参与者
activate / deactivate激活条跨度

能力边界

  • 分支标签共用消息行、嵌套框共用范围(漂移 D-20):alt 的标签可能和同一行的消息挤在一起,嵌套 fragment 的边框可能重合。写文档时尽量让分支块之间有间隔。
  • ZenUML 的返回形式缺失:B.doWork() => A 这种「点名调用方」的写法会被报成未识别,那个参与者和返回消息会缺。
  • 时间线画布是投影:拖参与者不会重排顺序,改顺序要改文本。
  • 这个编辑器里没有「时间约束/持续时间」标注(OMG Timing 语义),那是另一张图。