Skip to content

Elements ​

Choose an element by what it needs to do: hold text, connect other elements, organize a drawing, or display an image. The standard registry supplies the following elements without an optional shape library.

Browse the illustrated catalog · Appearance · Text and regions · Tables · Frames and groups

At a glance ​

ElementEditable appearanceTextResize and structure
RectangleFill, border, rounded cornersOne regionSide and corner handles
EllipseFill and borderOne inset regionSide and corner handles
PolygonFill, border, corners, side countOne inset regionSide and corner handles
PathFill, stroke, corners; open or closed geometryNoneEdit individual anchors and Bézier handles
DrawingInk color, width, preset and supported fillOne regionResize the authored drawing
CardFill, border and rounded cornersOptional tag, title and descriptionText can grow its height; four side ports
CommentFixed yellow paper and folded cornerEditable bodyText can grow its height
TableFill, border and corners; outer, row and column bordersBody text in each cellShape handles and row/column dividers
FrameFill, border and rounded cornersTitle above the frameResize boundary; child positions stay intact
GroupNo painted surfaceNoneResize children together
ImageSource and fitNoneResize image bounds
TextText formatting; no shape fill or borderRich TextWidth controls wrapping; content can grow height
ConnectorStroke, routing, arrowheads, labels and effectsLabel storiesEndpoints, bends and curve controls

These are the standard definitions. A host can register a different anatomy—outline, body regions, values, behavior, minimum sizes and ports. Locks and application admission rules can further restrict editing. The inspector only exposes properties allowed by the selected element's definition.

Beyond the standard toolkit ​

The optional Shapes library adds registered shapes such as start, end, decision and entity. They use the same drawing, selection, text, connection and history machinery. For example, the entity uses a title and embedded table sections rather than introducing a second text editor. See building a library.

Shapes.line remains available to read older drawings. It is not a separate creation tool: use Path (P) for authored lines and curves, or Connector (L) for connections between elements.

What is configured where? ​

  • Inspector: appearance and supported structural settings of the selected element.
  • Canvas: placement, selection, resizing, path points, text and table editing.
  • Shape definition: the shape's anatomy—outline, body parts (text regions, surfaces, images, widgets), values, ports, behavior and minimum/default sizes.

Adding another text region is a change to the definition's body, not an inspector operation. The default element catalog is not a promise that every element supports every property.