|
|
|
@@ -23,6 +23,7 @@ A draw.io XML file has the following hierarchy:
|
|
|
|
The root element of a draw.io file.
|
|
|
|
The root element of a draw.io file.
|
|
|
|
|
|
|
|
|
|
|
|
**Attributes:**
|
|
|
|
**Attributes:**
|
|
|
|
|
|
|
|
|
|
|
|
- `host`: The application that created the file (e.g., "app.diagrams.net")
|
|
|
|
- `host`: The application that created the file (e.g., "app.diagrams.net")
|
|
|
|
- `modified`: Last modification timestamp
|
|
|
|
- `modified`: Last modification timestamp
|
|
|
|
- `agent`: Browser / user agent information
|
|
|
|
- `agent`: Browser / user agent information
|
|
|
|
@@ -30,6 +31,7 @@ The root element of a draw.io file.
|
|
|
|
- `type`: File type (usually "device" or "google")
|
|
|
|
- `type`: File type (usually "device" or "google")
|
|
|
|
|
|
|
|
|
|
|
|
**Example:**
|
|
|
|
**Example:**
|
|
|
|
|
|
|
|
|
|
|
|
```xml
|
|
|
|
```xml
|
|
|
|
<mxfile host="app.diagrams.net" modified="2023-07-14T10:20:30.123Z" agent="Mozilla/5.0" version="21.5.2" type="device">
|
|
|
|
<mxfile host="app.diagrams.net" modified="2023-07-14T10:20:30.123Z" agent="Mozilla/5.0" version="21.5.2" type="device">
|
|
|
|
```
|
|
|
|
```
|
|
|
|
@@ -39,10 +41,12 @@ The root element of a draw.io file.
|
|
|
|
Each page in your draw.io document is represented by a `<diagram>` element.
|
|
|
|
Each page in your draw.io document is represented by a `<diagram>` element.
|
|
|
|
|
|
|
|
|
|
|
|
**Attributes:**
|
|
|
|
**Attributes:**
|
|
|
|
|
|
|
|
|
|
|
|
- `id`: Unique identifier for the diagram
|
|
|
|
- `id`: Unique identifier for the diagram
|
|
|
|
- `name`: The name of the diagram / page
|
|
|
|
- `name`: The name of the diagram / page
|
|
|
|
|
|
|
|
|
|
|
|
**Example:**
|
|
|
|
**Example:**
|
|
|
|
|
|
|
|
|
|
|
|
```xml
|
|
|
|
```xml
|
|
|
|
<diagram id="pWHN0msd4Ud1ZK5cD-Hr" name="Page-1">
|
|
|
|
<diagram id="pWHN0msd4Ud1ZK5cD-Hr" name="Page-1">
|
|
|
|
```
|
|
|
|
```
|
|
|
|
@@ -52,6 +56,7 @@ Each page in your draw.io document is represented by a `<diagram>` element.
|
|
|
|
Contains the actual diagram data.
|
|
|
|
Contains the actual diagram data.
|
|
|
|
|
|
|
|
|
|
|
|
**Attributes:**
|
|
|
|
**Attributes:**
|
|
|
|
|
|
|
|
|
|
|
|
- `dx`: Grid size in x-direction (usually 1)
|
|
|
|
- `dx`: Grid size in x-direction (usually 1)
|
|
|
|
- `dy`: Grid size in y-direction (usually 1)
|
|
|
|
- `dy`: Grid size in y-direction (usually 1)
|
|
|
|
- `grid`: Whether grid is enabled (0 or 1)
|
|
|
|
- `grid`: Whether grid is enabled (0 or 1)
|
|
|
|
@@ -69,6 +74,7 @@ Contains the actual diagram data.
|
|
|
|
- `shadow`: Whether shadows are enabled (0 or 1)
|
|
|
|
- `shadow`: Whether shadows are enabled (0 or 1)
|
|
|
|
|
|
|
|
|
|
|
|
**Example:**
|
|
|
|
**Example:**
|
|
|
|
|
|
|
|
|
|
|
|
```xml
|
|
|
|
```xml
|
|
|
|
<mxGraphModel dx="1" dy="1" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="1100" math="0" shadow="0">
|
|
|
|
<mxGraphModel dx="1" dy="1" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="1100" math="0" shadow="0">
|
|
|
|
```
|
|
|
|
```
|
|
|
|
@@ -78,10 +84,12 @@ Contains the actual diagram data.
|
|
|
|
Contains all the cells in the diagram.
|
|
|
|
Contains all the cells in the diagram.
|
|
|
|
|
|
|
|
|
|
|
|
**Example:**
|
|
|
|
**Example:**
|
|
|
|
|
|
|
|
|
|
|
|
```xml
|
|
|
|
```xml
|
|
|
|
<root>
|
|
|
|
<root>
|
|
|
|
<mxCell id="0"/>
|
|
|
|
<mxCell id="0"/>
|
|
|
|
<mxCell id="1" parent="0"/>
|
|
|
|
<mxCell id="1" parent="0"/>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- Other cells go here -->
|
|
|
|
<!-- Other cells go here -->
|
|
|
|
</root>
|
|
|
|
</root>
|
|
|
|
```
|
|
|
|
```
|
|
|
|
@@ -91,21 +99,25 @@ Contains all the cells in the diagram.
|
|
|
|
The basic building block of diagrams. Cells represent shapes, connectors, text, etc.
|
|
|
|
The basic building block of diagrams. Cells represent shapes, connectors, text, etc.
|
|
|
|
|
|
|
|
|
|
|
|
**Attributes for all cells:**
|
|
|
|
**Attributes for all cells:**
|
|
|
|
|
|
|
|
|
|
|
|
- `id`: Unique identifier for the cell
|
|
|
|
- `id`: Unique identifier for the cell
|
|
|
|
- `parent`: ID of the parent cell (typically "1" for most cells)
|
|
|
|
- `parent`: ID of the parent cell (typically "1" for most cells)
|
|
|
|
- `value`: Text content of the cell
|
|
|
|
- `value`: Text content of the cell
|
|
|
|
- `style`: Styling information (see Style section below)
|
|
|
|
- `style`: Styling information (see Style section below)
|
|
|
|
|
|
|
|
|
|
|
|
**Attributes for shapes (vertices):**
|
|
|
|
**Attributes for shapes (vertices):**
|
|
|
|
|
|
|
|
|
|
|
|
- `vertex`: Set to "1" for shapes
|
|
|
|
- `vertex`: Set to "1" for shapes
|
|
|
|
- `connectable`: Whether the shape can be connected (0 or 1)
|
|
|
|
- `connectable`: Whether the shape can be connected (0 or 1)
|
|
|
|
|
|
|
|
|
|
|
|
**Attributes for connectors (edges):**
|
|
|
|
**Attributes for connectors (edges):**
|
|
|
|
|
|
|
|
|
|
|
|
- `edge`: Set to "1" for connectors
|
|
|
|
- `edge`: Set to "1" for connectors
|
|
|
|
- `source`: ID of the source cell
|
|
|
|
- `source`: ID of the source cell
|
|
|
|
- `target`: ID of the target cell
|
|
|
|
- `target`: ID of the target cell
|
|
|
|
|
|
|
|
|
|
|
|
**Example (Rectangle shape):**
|
|
|
|
**Example (Rectangle shape):**
|
|
|
|
|
|
|
|
|
|
|
|
```xml
|
|
|
|
```xml
|
|
|
|
<mxCell id="2" value="Hello World" style="rounded=0;whiteSpace=wrap;html=1;" vertex="1" parent="1">
|
|
|
|
<mxCell id="2" value="Hello World" style="rounded=0;whiteSpace=wrap;html=1;" vertex="1" parent="1">
|
|
|
|
<mxGeometry x="350" y="190" width="120" height="60" as="geometry"/>
|
|
|
|
<mxGeometry x="350" y="190" width="120" height="60" as="geometry"/>
|
|
|
|
@@ -113,6 +125,7 @@ The basic building block of diagrams.Cells represent shapes, connectors, text, e
|
|
|
|
```
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
**Example (Connector):**
|
|
|
|
**Example (Connector):**
|
|
|
|
|
|
|
|
|
|
|
|
```xml
|
|
|
|
```xml
|
|
|
|
<mxCell id="3" value="" style="endArrow=classic;html=1;rounded=0;" edge="1" parent="1" source="2" target="4">
|
|
|
|
<mxCell id="3" value="" style="endArrow=classic;html=1;rounded=0;" edge="1" parent="1" source="2" target="4">
|
|
|
|
<mxGeometry width="50" height="50" relative="1" as="geometry">
|
|
|
|
<mxGeometry width="50" height="50" relative="1" as="geometry">
|
|
|
|
@@ -127,20 +140,26 @@ The basic building block of diagrams.Cells represent shapes, connectors, text, e
|
|
|
|
Defines the position and dimensions of cells.
|
|
|
|
Defines the position and dimensions of cells.
|
|
|
|
|
|
|
|
|
|
|
|
**Attributes for shapes:**
|
|
|
|
**Attributes for shapes:**
|
|
|
|
- `x`, `y`: Position coordinates
|
|
|
|
|
|
|
|
- `width`, `height`: Dimensions
|
|
|
|
- `x`: The x-coordinate of the **top-left** point of the shape.
|
|
|
|
- `as`: Set to "geometry"
|
|
|
|
- `y`: The y-coordinate of the **top-left** point of the shape.
|
|
|
|
|
|
|
|
- `width`: The width of the shape.
|
|
|
|
|
|
|
|
- `height`: The height of the shape.
|
|
|
|
|
|
|
|
- `as`: Specifies the role of this geometry within its parent cell. Typically set to `"geometry"` for the main shape definition.
|
|
|
|
|
|
|
|
|
|
|
|
**Attributes for connectors:**
|
|
|
|
**Attributes for connectors:**
|
|
|
|
|
|
|
|
|
|
|
|
- `relative`: Set to "1" for relative geometry
|
|
|
|
- `relative`: Set to "1" for relative geometry
|
|
|
|
- `as`: Set to "geometry"
|
|
|
|
- `as`: Set to "geometry"
|
|
|
|
|
|
|
|
|
|
|
|
**Example for shapes:**
|
|
|
|
**Example for shapes:**
|
|
|
|
|
|
|
|
|
|
|
|
```xml
|
|
|
|
```xml
|
|
|
|
<mxGeometry x="350" y="190" width="120" height="60" as="geometry"/>
|
|
|
|
<mxGeometry x="350" y="190" width="120" height="60" as="geometry"/>
|
|
|
|
```
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
**Example for connectors:**
|
|
|
|
**Example for connectors:**
|
|
|
|
|
|
|
|
|
|
|
|
```xml
|
|
|
|
```xml
|
|
|
|
<mxGeometry width="50" height="50" relative="1" as="geometry">
|
|
|
|
<mxGeometry width="50" height="50" relative="1" as="geometry">
|
|
|
|
<mxPoint x="400" y="430" as="sourcePoint"/>
|
|
|
|
<mxPoint x="400" y="430" as="sourcePoint"/>
|
|
|
|
@@ -150,24 +169,7 @@ Defines the position and dimensions of cells.
|
|
|
|
|
|
|
|
|
|
|
|
## Cell Style Reference
|
|
|
|
## Cell Style Reference
|
|
|
|
|
|
|
|
|
|
|
|
Styles are specified as semicolon - separated key = value pairs in the`style` attribute of `<mxCell>` elements.
|
|
|
|
Styles are specified as semicolon-separated `key=value` pairs in the `style` attribute of `<mxCell>` elements.
|
|
|
|
|
|
|
|
|
|
|
|
### Common Shape Styles
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- `rounded=1`: Rounded corners(0 or 1)
|
|
|
|
|
|
|
|
- `whiteSpace=wrap`: Text wrapping
|
|
|
|
|
|
|
|
- `html=1`: Enable HTML formatting
|
|
|
|
|
|
|
|
- `fillColor=#ffffff`: Background color(hex)
|
|
|
|
|
|
|
|
- `strokeColor=#000000`: Border color(hex)
|
|
|
|
|
|
|
|
- `strokeWidth=1`: Border width
|
|
|
|
|
|
|
|
- `fontSize=12`: Font size
|
|
|
|
|
|
|
|
- `fontColor=#000000`: Text color(hex)
|
|
|
|
|
|
|
|
- `align=center`: Text alignment(center, left, right)
|
|
|
|
|
|
|
|
- `verticalAlign=middle`: Vertical alignment(top, middle, bottom)
|
|
|
|
|
|
|
|
- `dashed=1`: Dashed border(0 or 1)
|
|
|
|
|
|
|
|
- `dashPattern=`: Dash pattern(e.g., "3 3")
|
|
|
|
|
|
|
|
- `opacity=50`: Opacity(0 - 100)
|
|
|
|
|
|
|
|
- `shadow=1`: Enable shadow(0 or 1)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Shape-specific Styles
|
|
|
|
### Shape-specific Styles
|
|
|
|
|
|
|
|
|
|
|
|
@@ -201,59 +203,20 @@ Draw.io files contain two special cells that are always present:
|
|
|
|
1. **Root Cell** (id = "0"): The parent of all cells
|
|
|
|
1. **Root Cell** (id = "0"): The parent of all cells
|
|
|
|
2. **Default Parent Cell** (id = "1", parent = "0"): The default layer and parent for most cells
|
|
|
|
2. **Default Parent Cell** (id = "1", parent = "0"): The default layer and parent for most cells
|
|
|
|
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Complete Basic Diagram
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
```xml
|
|
|
|
|
|
|
|
<mxfile host="app.diagrams.net" modified="2023-07-14T10:20:30.123Z" version="21.5.2" type="device">
|
|
|
|
|
|
|
|
<diagram id="pWHN0msd4Ud1ZK5cD-Hr" name="Page-1">
|
|
|
|
|
|
|
|
<mxGraphModel dx="1" dy="1" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="1100" math="0" shadow="0">
|
|
|
|
|
|
|
|
<root>
|
|
|
|
|
|
|
|
<mxCell id="0" />
|
|
|
|
|
|
|
|
<mxCell id="1" parent="0" />
|
|
|
|
|
|
|
|
<mxCell id="2" value="Start" style="ellipse;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="1">
|
|
|
|
|
|
|
|
<mxGeometry x="375" y="80" width="100" height="60" as="geometry" />
|
|
|
|
|
|
|
|
</mxCell>
|
|
|
|
|
|
|
|
<mxCell id="3" value="Process" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="1">
|
|
|
|
|
|
|
|
<mxGeometry x="365" y="200" width="120" height="60" as="geometry" />
|
|
|
|
|
|
|
|
</mxCell>
|
|
|
|
|
|
|
|
<mxCell id="4" value="End" style="ellipse;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;" vertex="1" parent="1">
|
|
|
|
|
|
|
|
<mxGeometry x="375" y="320" width="100" height="60" as="geometry" />
|
|
|
|
|
|
|
|
</mxCell>
|
|
|
|
|
|
|
|
<mxCell id="5" value="" style="endArrow=classic;html=1;rounded=0;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="2" target="3">
|
|
|
|
|
|
|
|
<mxGeometry width="50" height="50" relative="1" as="geometry">
|
|
|
|
|
|
|
|
<mxPoint x="400" y="430" as="sourcePoint" />
|
|
|
|
|
|
|
|
<mxPoint x="450" y="380" as="targetPoint" />
|
|
|
|
|
|
|
|
</mxGeometry>
|
|
|
|
|
|
|
|
</mxCell>
|
|
|
|
|
|
|
|
<mxCell id="6" value="" style="endArrow=classic;html=1;rounded=0;exitX=0.5;exitY=1;exitDx=0;exitDy=0;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="3" target="4">
|
|
|
|
|
|
|
|
<mxGeometry width="50" height="50" relative="1" as="geometry">
|
|
|
|
|
|
|
|
<mxPoint x="400" y="430" as="sourcePoint" />
|
|
|
|
|
|
|
|
<mxPoint x="450" y="380" as="targetPoint" />
|
|
|
|
|
|
|
|
</mxGeometry>
|
|
|
|
|
|
|
|
</mxCell>
|
|
|
|
|
|
|
|
</root>
|
|
|
|
|
|
|
|
</mxGraphModel>
|
|
|
|
|
|
|
|
</diagram>
|
|
|
|
|
|
|
|
</mxfile>
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Tips for Manually Creating Draw.io XML
|
|
|
|
## Tips for Manually Creating Draw.io XML
|
|
|
|
|
|
|
|
|
|
|
|
1. Start with the basic structure(mxfile, diagram, mxGraphModel, root)
|
|
|
|
1. Start with the basic structure (`mxfile`, `diagram`, `mxGraphModel`, `root`)
|
|
|
|
2. Always include the two special cells (id = "0" and id = "1")
|
|
|
|
2. Always include the two special cells (id = "0" and id = "1")
|
|
|
|
3. Assign unique and sequential IDs to all cells
|
|
|
|
3. Assign unique and sequential IDs to all cells
|
|
|
|
4. Define parent relationships correctly
|
|
|
|
4. Define parent relationships correctly
|
|
|
|
5. Use geometry elements to position shapes
|
|
|
|
5. Use `mxGeometry` elements to position shapes
|
|
|
|
6. For connectors, specify source and target attributes
|
|
|
|
6. For connectors, specify `source` and `target` attributes
|
|
|
|
7. Test your XML by opening it in draw.io
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Common Patterns
|
|
|
|
## Common Patterns
|
|
|
|
|
|
|
|
|
|
|
|
### Grouping Elements
|
|
|
|
### Grouping Elements
|
|
|
|
|
|
|
|
|
|
|
|
To group elements, create a parent cell and set other cells' parent attribute to its ID:
|
|
|
|
To group elements, create a parent cell and set other cells' `parent` attribute to its ID:
|
|
|
|
|
|
|
|
|
|
|
|
```xml
|
|
|
|
```xml
|
|
|
|
<!-- Group container -->
|
|
|
|
<!-- Group container -->
|
|
|
|
@@ -287,7 +250,7 @@ Tables use multiple cells with parent - child relationships:
|
|
|
|
<mxCell id="30" value="Table" style="shape=table;startSize=30;container=1;collapsible=1;childLayout=tableLayout;fixedRows=1;rowLines=0;fontStyle=1;align=center;resizeLast=1;html=1;" vertex="1" parent="1">
|
|
|
|
<mxCell id="30" value="Table" style="shape=table;startSize=30;container=1;collapsible=1;childLayout=tableLayout;fixedRows=1;rowLines=0;fontStyle=1;align=center;resizeLast=1;html=1;" vertex="1" parent="1">
|
|
|
|
<mxGeometry x="200" y="200" width="180" height="120" as="geometry" />
|
|
|
|
<mxGeometry x="200" y="200" width="180" height="120" as="geometry" />
|
|
|
|
</mxCell>
|
|
|
|
</mxCell>
|
|
|
|
<mxCell id="31" value="" style="shape=tableRow;horizontal=0;startSize=0;swimlaneHead=0;swimlaneBody=0;fillColor=none;collapsible=0;dropTarget=0;points=[[0,0.5],[1,0.5]];portConstraint=eastwest;top=0;left=0;right=0;bottom=1;" vertex="1" parent="30">
|
|
|
|
<mxCell id="31" value="" style="shape=tableRow;horizontal=0;startSize=0;swimlaneHead=0;swimlaneBody=0;fillColor=none;collapsible=0;dropTarget=0;points=[0,0.5,1,0.5];portConstraint=eastwest;top=0;left=0;right=0;bottom=1;" vertex="1" parent="30">
|
|
|
|
<mxGeometry y="30" width="180" height="30" as="geometry" />
|
|
|
|
<mxGeometry y="30" width="180" height="30" as="geometry" />
|
|
|
|
</mxCell>
|
|
|
|
</mxCell>
|
|
|
|
```
|
|
|
|
```
|
|
|
|
@@ -335,4 +298,3 @@ You can create multiple layers in a diagram to organize complex diagrams:
|
|
|
|
<mxGeometry x="200" y="300" width="120" height="60" as="geometry"/>
|
|
|
|
<mxGeometry x="200" y="300" width="120" height="60" as="geometry"/>
|
|
|
|
</mxCell>
|
|
|
|
</mxCell>
|
|
|
|
```
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|