Balloon Layout

This layout groups vertices into clusters.

This layout is useful for unstructured data - database schemas, mind maps, graphs, etc. For a given input graph the structure of the layout will always be the same, but this layout does not extend the Absolute layout as the ForceDirected layout does, so all vertex placement is decided upon by the layout.

Balloon layout

---

Parameters

Interface BalloonLayoutParameters

Name	Type	Description
absoluteBacked?	boolean	Defaults to false. If true, then the layout will use any position values found in the data for a given vertex.
getChildVertices?	HierarchicalLayoutChildVerticesFunction	Optional function used to determine the edges to traverse to find children from some node
getRootNode?		Optional. A function that is given the Toolkit instance as argument and is expected to return either a single node/group, or an array of nodes/groups, to use as the root(s) for the layout
groupPadding?	number	Minimum distance between a group of vertices and its neighbours. Defaults to 100 pixels.
height?	number	Optional fixed height for the layout.
ignoreLoops?	boolean	Defaults to true. If a loop is found during the layout it is usually ignored, unless this is set to true.
ignorePorts?	boolean	Defaults to false, meaning that ports are taken into account when figuring the list of edges from some vertex. If you set this to true, ports will be ignored and the layout will only consider edges connected directly to each vertex.
locationFunction?	LocationFunction	Optional function that, given some vertex, can provide the x/y location of the vertex on the canvas
multipleRoots?	boolean	Optional, defaults to true. If false, multiple roots are not supported, and assuming you have not overridden getRootNode, the layout uses the first node found in the dataset (otherwise it still uses the result of your getRootNode function)
padding?	PointXY	Optional padding to put around the elements.
rootNode?	Array<Vertex>	Optional. Defines the node/group to use as the root of the tree. This may be provided either as a node/group id or as a node/group object. If this parameter is not specified and multipleRoots is not false then the layout uses the result(s) of the getRootNode function; otherwise it uses the first node/group found in the dataset.
width?	number	Optional fixed width for the layout.

---

Example

Vanilla JS

React

Angular

Vue

Svelte

import { newInstance,
	BalloonLayout } from "@jsplumbtoolkit/browser-ui"

const toolkit = newInstance()
    
const surface = toolkit.render(someElement, {
  "layout": {
    "type": BalloonLayout.type
  }
});

---

Behaviour after relayout

A relayout will generate the exact same arrangement of vertices, since this layout is deterministic. But any changes to node/group dimensions will be taken into account.

---

Behaviour after refresh

A refresh will generate the exact same arrangement of nodes/groups, since this layout is deterministic. But any changes to node/group dimensions will be taken into account.