Optional
allowWhether or not to allow edges from this vertex back to itself. Defaults to true.
This flag will not prevent an edge from a port back to the node/group to
which it belongs - for that, see allowVertexLoopback
.
Optional
allowWhen autoShrink
or autoSize
is set to true, this is also implicitly true, meaning that a group can be shrunk from its left/top edge. Set this to
default if you do not want that behaviour.
Optional
allowWhether or not to allow edges from a port back to the vertex it belongs to. Defaults to true.
Optional
anchorSpec for the anchor to use for connections to children of the group when they are transferred to the group in its collapsed state.
Optional
anchorOptional function to call on connection drop, to determine the location for the target anchor for the new connection. Returning null
from this indicates no preference, and the Toolkit will use its own computed value. Note that the return value from this method is ArrayAnchorSpec
,
meaning an array in the format [ x, y, orientationX, orientationY, offsetX, offsetY ]. Note also that offsetX
and offsetY
are optional,
and will be defaulted to 0.
Optional
anchorOptional array of anchor positions to use.
Optional
autoDefaults to false, meaning that the group will not be resized if an item addition/removal or drag causes the bounds of the child members to change and the new size is greater than the previous size.
Optional
autoFalse by default. If true indicates that if a child member is dragged/added/removed and the group's size is recalculated to be smaller than
the previous size, the new size should be applied. From 6.10.0 this also works if the group needs to shrink from its left and/or top edge. If you don't
want that behaviour, set allowShrinkFromOrigin
to false.
Optional
autoFalse by default. From version 6.10.0 onwards this flag switches on both autoShrink
and autoGrow
and also enables support for shrinking a group from
its left or top edge, a feature that was not available in previous versions. If you're on 6.10.0+ and you want to setup your UI to be how it used to be with
just this flag set, also set autoShrink
to false. If you previously had autoShrink
set to true but you don't like the shrink from left/top functionality,
set allowShrinkFromOrigin
to false.
Optional
constrainFalse by default - nodes/groups may be dragged outside of the bounds of the group. When you do drag a node/group outside of the bounds of its parent, what happens next depends on the other flags you have set and where you have dropped it. orphan:true
, for instance, will cause the node/group to be removed from its parent group. revert
will reinstate the node/group's position inside its parent, unless it was dropped on another group.
Optional
defaultOptional default size to use for the vertex. This is not used to set the size in the DOM for a vertex - it is used
to insert width
and height
values into the backing data for any vertex of this type that does not have them set.
Optional
dropFalse by default. If true, Nodes dropped onto other Groups first have any rules established by this Group applied. For instance, if the Groups stated prune:true
, then the Node would be removed from the dataset rather than be dropped onto another Group.
Optional
droppableTrue by default - indicates that nodes/groups may be dropped onto the group, either from some other group or from the main canvas.
Optional
elasticSimilar to autoGrow, but with a couple of differences:
Optional
elementsTrue by default - indicates that child members may be dragged around inside the group.
Optional
endpointSpec for the endpoint to use for connections to children of the group when they are transferred to the group in its collapsed state.
Optional
eventsOptional map of event bindings.
Optional
ghostWhether or not to show a 'ghost' element when an element inside the group is dragged to the point that it extends outside the bounds of the group. The original element remains inside the group. Defaults to false.
Optional
layoutOptions for the group's layout.
Optional
options?: LayoutParametersOptional
maxMaximum number of connections this vertex supports. Default is 1. A value of -1 means no limit.
Optional
maxMaximum size the group can grow to. If not specified the group can grow to an arbitrary size. Note that this behaviour can also be enforced via CSS.
Optional
mergeWhen merging a type description into its parent(s), values in the child for connector
, anchor
and anchors
will
always overwrite any such values in the parent. But other values, such as overlays
, will be merged with their
parent's entry for that key. You can force a child's type to override every corresponding value in its parent by
setting mergeStrategy:'override'
.
Optional
minMinimum size the group can be. This is only used when
Optional
orphanFalse by default. If true, nodes/groups dropped outside of the group (and not dropped onto another group) are removed from the group (but remain in the dataset). When you set this to true
, revert
is automatically forced to false
.
Optional
paddingOptional padding to set inside a group when computing an auto size.
Optional
parametersA map of parameters that the template engine will merge with the backing data when rendering the vertex.
Optional
parentOptional ID of one or more edge definitions to include in this definition. The child definition is merged on top of the parent definition(s). Circular references are not allowed and will throw an error.
Optional
pruneFalse by default. If true, Nodes dropped outside of the Group (and not dropped onto another Group) are removed from the dataset (not just the Group...the entire dataset).
Optional
revertTrue by default - a node/group dragged outside of its parent group will, unless dropped on another group, revert back to its position inside the group.
Optional
templateTemplate to use for a vertex of this type. This is only for 'vanilla' Toolkit: if you are using an integration such as React/Angular/Vue/Svelte, you
will not need to provide this. If you provide this and also templateId
, this will take precedence.
Optional
templateID of the template to use for a vertex of this type. This is only for 'vanilla' Toolkit: if you are using an integration such as React/Angular/Vue, you
will not need to provide this. This parameter is distinct from template
in that when you provide templateId
you are expecting the Toolkit to resolve
the template for you, either from a templates
block in a render
call, or by looking for a script element in the DOM with the appropriate ID. If you
provide this and also template
, template
will take precedence.
The mapping for the definition of a group inside a view.