syncfusion/blazor-ui-components-skills / skills/syncfusion-blazor-diagram
syncfusion-blazor-diagram
VerifiedBuild and troubleshoot Syncfusion Blazor diagrams using SfDiagramComponent. Trigger for flowcharts, org charts, mind maps, BPMN, UML sequence, swimlanes, symbol palettes, nodes/connectors/ports/annotations, layouts, data binding, serialization (load/save), export/print, and collaborative editing questions. Provide Blazor + Syncfusion setup steps, configuration patterns, and sample snippets.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 28.6 KB |
| references/advanced-features.md | markdown | 10.0 KB |
| references/annotations.md | markdown | 11.9 KB |
| references/bpmn.md | markdown | 6.6 KB |
| references/collaborative-editing.md | markdown | 7.0 KB |
| references/connectors.md | markdown | 6.4 KB |
| references/data-binding.md | markdown | 12.8 KB |
| references/events.md | markdown | 52.7 KB |
| references/export-print.md | markdown | 5.9 KB |
| references/getting-started.md | markdown | 5.4 KB |
| references/interaction.md | markdown | 36.7 KB |
| references/layout.md | markdown | 12.3 KB |
| references/nodes.md | markdown | 8.6 KB |
| references/overview-component.md | markdown | 5.5 KB |
| references/ports.md | markdown | 5.1 KB |
| references/serialization.md | markdown | 3.5 KB |
| references/shapes.md | markdown | 6.2 KB |
| references/styling.md | markdown | 6.1 KB |
| references/swimlane.md | markdown | 6.1 KB |
| references/symbol-palette.md | markdown | 7.7 KB |
| references/uml-class-diagram.md | markdown | 25.5 KB |
| references/uml-sequence.md | markdown | 6.5 KB |
references/swimlane.md
View on GitHub# Swimlane in Blazor Diagram
## Table of Contents
- [Overview](#overview)
- [Creating a Swimlane](#creating-a-swimlane)
- [Swimlane Header](#swimlane-header)
- [Lanes](#lanes)
- [Phases](#phases)
- [Adding Nodes Inside Lanes](#adding-nodes-inside-lanes)
- [Swimlane Orientation](#swimlane-orientation)
- [Common Gotchas](#common-gotchas)
---
## Overview
Swimlanes visualize business processes divided by department or responsibility. Each swimlane contains lanes (horizontal/vertical divisions) and phases (time/process stages).
- **Lanes:** Horizontal or vertical divisions representing roles/departments
- **Phases:** Columns or rows representing stages of the process
- **Children:** Nodes placed inside lanes
---
## Creating a Swimlane
```razor
@using Syncfusion.Blazor.Diagram
<SfDiagramComponent Height="600px" Swimlanes="@swimlanes" NodeCreating="OnNodeCreating" />
@code {
DiagramObjectCollection<Swimlane> swimlanes = new();
protected override void OnInitialized()
{
swimlanes.Add(new Swimlane
{
ID = "swimlane1",
OffsetX = 400, OffsetY = 300,
Width = 600, Height = 200
});
}
private void OnNodeCreating(IDiagramObject obj)
{
if (obj is Swimlane sl)
{
sl.Header.Style = new TextStyle { Fill = "#5b9bd5", StrokeColor = "#5b9bd5" };
foreach (var phase in sl.Phases)
phase.Style = new ShapeStyle { Fill = "#5b9bd5", StrokeColor = "#5b9bd5" };
foreach (var lane in sl.Lanes)
lane.Header.Style = new TextStyle { Fill = "#5b9bd5", StrokeColor = "#5b9bd5" };
}
}
}
```
> By default, a swimlane is created with one lane and one phase.
> **⚠️ Swimlane ID rules:** Must not start with a number or contain underscores/spaces.
---
## Swimlane Header
```razor
new Swimlane
{
ID = "sl1",
OffsetX = 400, OffsetY = 300,
Width = 600, Height = 300,
Header = new SwimlaneHeader
{
Annotation = new ShapeAnnotation { Content = "Order Process" },
Style = new TextStyle { Fill = "#5b9bd5", StrokeColor = "#5b9bd5", Color = "white", Bold = true }
}
}
```
---
## Lanes
Configure multiple lanes inside a swimlane:
```razor
new Swimlane
{
ID = "sl1",
OffsetX = 400, OffsetY = 300,
Width = 600, Height = 400,
Lanes = new DiagramObjectCollection<Lane>
{
new Lane
{
ID = "lane1",
Header = new SwimlaneHeader
{
Annotation = new ShapeAnnotation { Content = "Sales" },
Width = 30
},
Height = 130,
Style = new ShapeStyle { Fill = "#E8F4FC" }
},
new Lane
{
ID = "lane2",
Header = new SwimlaneHeader
{
Annotation = new ShapeAnnotation { Content = "Support" },
Width = 30
},
Height = 130,
Style = new ShapeStyle { Fill = "#F0FFF0" }
}
}
}
```
---
## Phases
Add phases (column/stage divisions) to the swimlane:
```razor
new Swimlane
{
ID = "sl1",
Width = 700, Height = 300,
Phases = new DiagramObjectCollection<Phase>
{
new Phase
{
ID = "phase1",
Header = new SwimlaneHeader
{
Annotation = new ShapeAnnotation { Content = "Phase 1" }
},
Width = 200,
Style = new ShapeStyle { Fill = "#5b9bd5", StrokeColor = "#5b9bd5" }
},
new Phase
{
ID = "phase2",
Header = new SwimlaneHeader
{
Annotation = new ShapeAnnotation { Content = "Phase 2" }
},
Width = 200
}
}
}
```
---
## Adding Nodes Inside Lanes
Place nodes inside lanes using the `Lane.Children` collection. Use `LaneOffsetX` and `LaneOffsetY` (relative to the lane's own coordinate space) to position each child node — do **not** use `OffsetX`/`OffsetY` or `ParentID` for lane children:
```razor
@code {
DiagramObjectCollection<Swimlane> _swimlaneCollections = new DiagramObjectCollection<Swimlane>();
protected override void OnInitialized()
{
// This node will appear inside lane1 of swimlane sl1
_swimlaneCollections.Add(
new Swimlane()
{
Lanes = new DiagramObjectCollection<Lane>()
{
new Lane(){
Height = 100,
Header = new SwimlaneHeader(){
Width = 30,
Annotation = new ShapeAnnotation(){ Content = "Consumer" }
},
Children = new DiagramObjectCollection<Node>()
{
new Node(){Height = 50, Width = 50, LaneOffsetX = 250, LaneOffsetY = 30},
}
},
}
});
}
}
```
> Use `LaneOffsetX`/`LaneOffsetY` to position child nodes relative to the lane's coordinate space — **not** `OffsetX`/`OffsetY`.
---
## Swimlane Orientation
```razor
new Swimlane
{
Orientation = Orientation.Horizontal // default
// Orientation = Orientation.Vertical
}
```
- **Horizontal:** Lanes stack vertically, phases run left-to-right
- **Vertical:** Lanes stack horizontally, phases run top-to-bottom
---
## Common Gotchas
- **Swimlane ID must be unique** and must not start with a number or contain underscores/spaces
- **Swimlane elements cannot be added at runtime** using `AddDiagramElementsAsync` — define all lanes/phases in `OnInitialized`
- **Lane children use `Lane.Children`** — add nodes via `Lane.Children = new DiagramObjectCollection<Node> { ... }` with `LaneOffsetX`/`LaneOffsetY` for positioning; do **not** use `ParentID` or `OffsetX`/`OffsetY` for lane-child nodes
- **`NodeCreating` callback** is the right place to style swimlane headers, lanes, and phases
- **Default behavior:** One lane and one phase are created automatically when no lanes/phases are defined
- **Phases are optional** — a swimlane can work with only lanes and no phases
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |