Constructs a TextBlock, which by default has no string to show; if it did, it would draw the text, wrapping if needed, in the default font using a black stroke.
Typical usage:
new go.TextBlock("Hello World", { font: "12px sans-serif", stroke: "gray" })
It is common to data-bind the text:
// A Node used as the node template, holding a single TextBlock
myDiagram.nodeTemplate =
new go.Node()
.add(
new go.TextBlock({ font: "12px sans-serif", stroke: "darkgray" })
.bind("text")
);
// It could be used with model data like this:
myDiagram.model = new go.GraphLinksModel(
[
{ key: "1", text: "First TextBlock" },
{ key: "2", text: "Second TextBlock" }
]);
Optionaltext: stringThe textblock's text.
Optionalinit: Partial<TextBlock>Optional initialization properties.
Gets or sets the function to execute when the ActionTool is cancelled and this GraphObject's isActionable is set to true. This property is infrequently set. By default this property is null.
This functional property is only set on objects such as buttons, knobs, or sliders that want to handle all events, in conjunction with ActionTool, pre-empting the normal tool mechanisms.
The ActionTool does not conduct any transaction, so if this property has a value, the function will not be called within a transaction.
Gets or sets the function to execute on a mouse-down event when this GraphObject's isActionable is set to true. This property is infrequently set. By default this property is null.
This functional property is only set on objects such as buttons, knobs, or sliders that want to handle all events, in conjunction with ActionTool, pre-empting the normal tool mechanisms.
The ActionTool does not conduct any transaction, so if this property has a value, the function will not be called within a transaction.
Gets or sets the function to execute on a mouse-move event when this GraphObject's isActionable is set to true. This property is infrequently set. By default this property is null.
This functional property is only set on objects such as buttons, knobs, or sliders that want to handle all events, in conjunction with ActionTool, pre-empting the normal tool mechanisms.
The ActionTool does not conduct any transaction, so if this property has a value, the function will not be called within a transaction.
Gets or sets the function to execute on a mouse-up event when this GraphObject's isActionable is set to true. This property is infrequently set. By default this property is null.
This functional property is only set on objects such as buttons, knobs, or sliders that want to handle all events, in conjunction with ActionTool, pre-empting the normal tool mechanisms.
The ActionTool does not conduct any transaction, so if this property has a value, the function will not be called within a transaction. If you do provide a function that makes changes to the diagram or to its model, you should do so within a transaction -- call Diagram.startTransaction and Diagram.commitTransaction.
ReadonlyactualThis read-only property returns the bounds of this GraphObject in container coordinates. This means that the actualBounds are in the coordinate space of the GraphObject's Panel, unless this is a Part, in which case they are in the Diagram's coordinate system.
You must not modify any of the properties of the Rect that is the value of this property.
If this GraphObject is a Part, then the x and y values of the actualBounds are identical to that Part's position, and the width and height values of the actualBounds represent the rectangular space occupied by the Part in Diagram.documentBounds coordinates.
If this GraphObject is not a top-level object (not a Part), then the actualBounds x and y values represent that GraphObject's position within its Panel. In a Panel of type Panel.Position this is identical to the GraphObject's position, but in other cases it is dependent on the unique workings of each Panel type. The actualBounds width and height of a GraphObject are the final size after the scale and angle are applied.
It is possible for a GraphObject (be it an GraphObject or a Panel containing several more GraphObjects) to have no containing Part, in which case these GraphObjects cannot possibly be in a Diagram. These GraphObjects are unlikely to have real-number values for their actualBounds, as they may never have had the chance to be measured and arranged.
As with all read-only properties, using this property as a binding source is unlikely to be useful.
Gets or sets the alignment Spot of this GraphObject used in Panel layouts, to determine where in the area allocated by the panel this object should be placed.
The default value is Spot.Default, which lets the Panel determine the Spot using Panel.defaultAlignment. If that property is also Spot.Default, then the alignment spot will be different depending on the Panel type.
The alignmentFocus is often used along with this property to specify where this object should be positioned in a Panel.
A Spot.Default is equivalent to Spot.Center in Spot, Auto, Horizontal, and Vertical panels. For examples of alignments in different panels, see the Learn page on Panels.
Gets or sets the spot on this GraphObject to be used as the alignment point in Spot and Fixed Panels. Value must be of the Spot.
The default value is Spot.Default, which means that the Panel type can decide the effective alignment spot.
The alignment is often used along with this property to specify where this object should be positioned in a Panel.
For Panel.Graduated, the alignmentFocus spot determines the spot on a child element to be aligned with some point along the main element.
When you want a link label Node to be positioned by its location spot rather than by this alignmentFocus spot, you can set this property to Spot.None, only on Nodes.
For examples of alignments in different panels, see the Learn page on Panels.
Gets or sets the angle transform, in degrees, of this GraphObject. Value must be a number. If the value is not between (0 <= value < 360), it will be normalized to be in that range. Zero is along the positive X-axis (rightwards); 90 is along the positive Y-axis (downwards). Default is 0.
When set on a Graduated Panel's TextBlock label, this value will be be ignored if segmentOrientation is not Orientation.None, Orientation.Along, or Orientation.Upright. OrientAlong and OrientUpright will use this angle relative to the slope of the main path.
When set on a Link label, this value will be be ignored if segmentOrientation is not Orientation.None.
Gets or sets the background Brush of this GraphObject, filling the rectangle of this object's local coordinate space. If the object is rotated, the background will rotate with it.
The value may be either a Brush object or a string that is a CSS color. The default value is null -- no background is drawn. More information about the syntax of CSS color strings is available at: CSS colors (mozilla.org).
see
Gets or sets the an array of possible choices for a custom TextEditingTool. The value must be an array of strings.
The default value is null. For example usage, see the Custom TextEditingTool Sample.
Gets or sets the function to execute when the user single-primary-clicks on this object.
This typically involves a mouse-down followed by a prompt mouse-up
at approximately the same position using the left (primary) mouse button.
This property is used by the ClickSelectingTool
when the user clicks on a GraphObject.
The function is called in addition to the DiagramEvent
that is raised with the name "ObjectSingleClicked".
If this property value is a function, it is called with an InputEvent and this GraphObject. The InputEvent.targetObject provides the GraphObject that was found at the mouse point before looking up the visual tree of GraphObject.panels to get to this object.
From the second argument, obj, you can get to the Node or Link via the part property.
From there you can access the bound data via the Panel.data property.
So from an event handler you can get the bound data by obj.part.data.
By default this property is null.
Objects in Layers that are Layer.isTemporary do not receive click events. If you do want such objects to respond to clicks, set isActionable to true.
If you do provide a function that makes changes to the diagram or to its model, you should do so within a transaction -- call Diagram.startTransaction and Diagram.commitTransaction.
An example of a click event handler is shown in the Arrowheads sample.
Gets or sets the column of this GraphObject if it is in a Table Panel. The value must be a small non-negative integer. The default is 0.
Gets or sets the number of columns spanned by this GraphObject if it is in a Table Panel. The value must be a small positive integer. The default is 1.
Gets or sets the function to execute when the user single-secondary-clicks on this object.
This typically involves a mouse-down followed by a prompt mouse-up
at approximately the same position using the right (secondary) mouse button.
This property is used by the ClickSelectingTool
when the user clicks on a GraphObject.
The function is called in addition to the DiagramEvent
that is raised with the name "ObjectContextClicked".
If this property value is a function, it is called with an InputEvent and this GraphObject. The InputEvent.targetObject provides the GraphObject that was found at the mouse point before looking up the visual tree of GraphObject.panels to get to this object.
From the second argument, obj, you can get to the Node or Link via the part property.
From there you can access the bound data via the Panel.data property.
So from an event handler you can get the bound data by obj.part.data.
By default this property is null.
Objects in Layers that are Layer.isTemporary do not receive click events. If you do want such objects to respond to clicks, set isActionable to true.
If you do provide a function that makes changes to the diagram or to its model, you should do so within a transaction -- call Diagram.startTransaction and Diagram.commitTransaction.
This Adornment or HTMLInfo is shown upon a context click on this object. The default value is null, which means no context menu is shown.
Changing this value will not modify or remove any existing menu that is being shown for this object.
Context menus may also depend on having the same data binding as the adorned Part (i.e. the same value for Panel.data).
Context menus are not copied by copy, so that context menus may be shared by all instances of a template.
A typical context menu is implemented as an Adornment with several buttons in it. For example, this context menu is defined in the Dynamic Port sample:
const nodeMenu = // context menu for each Node
go.GraphObject.build("ContextMenu").add(
go.GraphObject.build("ContextMenuButton",
{ click: (e, obj) => addPort("top") })
.add(new go.TextBlock("Add top port")),
go.GraphObject.build("ContextMenuButton",
{ click: (e, obj) => addPort("left") })
.add(new go.TextBlock("Add left port")),
go.GraphObject.build("ContextMenuButton",
{ click: (e, obj) => addPort("right") })
.add(new go.TextBlock("Add right port")),
go.GraphObject.build("ContextMenuButton",
{ click: (e, obj) => addPort("bottom") })
.add(new go.TextBlock("Add bottom port"))
);
and is used in the node template:
myDiagram.nodeTemplate =
new go.Node("Table",
{ . . .
contextMenu: nodeMenu
}).add(
. . .
);
Context menus are normally positioned by ContextMenuTool.positionContextMenu. However, if there is a Placeholder in the context menu, the context menu (i.e. an Adornment) will be positioned so that the Placeholder is at the same position as this adorned GraphObject.
The Basic sample also shows how to make context menu items invisible when the command is disabled.
Replacing this value will not modify or remove any existing context menu that is being shown for this object.
Read more about context menus at Context Menus.
Gets or sets the mouse cursor to use when the mouse is over this object with no mouse buttons pressed. The value is the empty string when no particular cursor is specified for this object; the actual cursor is determined by any containing Panel.
The default value is the empty string, which means the current mouse cursor is determined by the Diagram. Other strings should be valid CSS strings that specify a cursor. This provides some more information about cursor syntax: CSS cursors (mozilla.org).
Read more about cursors at Diagram.currentCursor
Gets or sets the desired size of this GraphObject in local coordinates. Value must be of type Size. Default is Size(NaN, NaN). You cannot modify the width or height of the value of this property -- if you want to change the desiredSize you must set this property to a different Size.
Getting or setting width or height is equivalent to getting or setting the width or height of this property.
The size does not include any transformation due to scale or angle, nor any pen thickness due to Shape.strokeWidth if this is a Shape. If there is a containing Panel the Panel will determine the actual size. If the desiredSize is greater than the allowed size that the GraphObject's Panel determines, then the GraphObject may be visually clipped. If the desiredSize does not meet the constraints of minSize and maxSize, the GraphObject will be resized to meet them.
ReadonlydiagramThis read-only property returns the Diagram that this GraphObject is in, if it is.
This property is not settable. Although you cannot add any plain GraphObject to a Diagram, you can call Diagram.add to add a Part to a Diagram.
Gets or sets the function to execute when the user double-primary-clicks on this object.
This typically involves a mouse-down/up/down/up in rapid succession
at approximately the same position using the left (primary) mouse button.
This property is used by the ClickSelectingTool
when the user clicks on a GraphObject.
The function is called in addition to the DiagramEvent
that is raised with the name "ObjectDoubleClicked".
If this property value is a function, it is called with an InputEvent and this GraphObject. The InputEvent.targetObject provides the GraphObject that was found at the mouse point before looking up the visual tree of GraphObject.panels to get to this object.
From the second argument, obj, you can get to the Node or Link via the part property.
From there you can access the bound data via the Panel.data property.
So from an event handler you can get the bound data by obj.part.data.
By default this property is null.
Objects in Layers that are Layer.isTemporary do not receive click events. If you do want such objects to respond to clicks, set isActionable to true.
If you do provide a function that makes changes to the diagram or to its model, you should do so within a transaction -- call Diagram.startTransaction and Diagram.commitTransaction.
The Class Hierarchy sample demonstrates the definition of a double-click event handler that opens up a web page with the documentation for that class:
diagram.nodeTemplate =
new go.Node(...,
{
doubleClick: // here the second argument is this object, which is this Node
(e, node) => { window.open("../api/symbols/" + node.data.key + ".html"); }
}).add(
// elements for Node...
)
Gets or sets whether or not this TextBlock allows in-place editing of the text string by the user with the help of the TextEditingTool. The default is false.
See also Part.textEditable.
Gets or sets the function to execute when some containing Panel changes the value of Panel.isEnabled. It is typically used to modify the appearance of the object. This function must not change the value of any panel Panel.isEnabled.
If this property value is a function, it is called with two arguments, this GraphObject and the new value. By default this property is null -- no function is called.
Gets or sets the function to call if a text edit made with the TextEditingTool is invalid. The default is null.
Gets or sets how the TextBlock is displayed: Either normally or with a Horizontal or Vertical flip or both.
Possible values are Flip.None, Flip.Horizontal, Flip.Vertical, or Flip.Both. The default is Flip.None.
since2.0
Gets or sets the current font settings. The font property must be a valid CSS string describing a font. The font string can accept several CSS properties but they must be in a specific order in order to render correctly across all browsers:
"font-style font-variant font-weight font-size font-family"
For example, "Italic small-caps bold 32px Georgia, Serif" is a valid font string
using every CSS font property. Not every browser can render every font option.
For more information about CSS font syntax, see CSS fonts (mozilla.org).
If your Node sizes depend on TextBlocks, it is best to ensure any custom fonts you are using are finished loading before you load your Diagram. This will ensure nodes are sized appropriately for the initial Diagram layout.
The default font is "13px sans-serif".
Gets or sets the policy for trimming whitespace on each line of text.
Possible values are TextFormat.Trim, which trims whitespace before and after every line of text, or TextFormat.None, which will not trim any whitespace and may be useful for preformatted text. The default is TextFormat.Trim.
since2.2
Gets or sets the length of the first segment of a link coming from this port. This value is used when the computed "from spot" is not Spot.None. The default value is 10. This value also limits how short the Link.fromShortLength may be drawn.
The value of Link.fromEndSegmentLength, if not NaN, takes precedence over the value at this port when determining the route of the link.
For examples of how to use this property, see Link End Segment Lengths.
You must set this property on a GraphObject whose portId is non-null, unless the whole Node is acting as a single port, in which case this property should be set on the Node.
Gets or sets whether the user may draw Links from this port. This property is used by LinkingBaseTool.isValidFrom.
The default value is null, which indicates that the real value is inherited from the parent Panel, or false if there is no containing panel.
You must set this property on a GraphObject whose portId is non-null, unless the whole Node is acting as a single port, in which case this property should be set on the Node, or unless you are disabling the "linkability" of a particular GraphObject inside a Panel whose fromLinkable has been set or bound to true.
Gets or sets whether the user may draw duplicate Links from this port. This property is used by LinkingBaseTool.isValidLink. The default value is false.
You must set this property on a GraphObject whose portId is non-null, unless the whole Node is acting as a single port, in which case this property should be set on the Node.
Gets or sets whether the user may draw Links that connect from this port's Node. This property is used by LinkingBaseTool.isValidLink. The default value is false.
You must set this property on a GraphObject whose portId is non-null, unless the whole Node is acting as a single port, in which case this property should be set on the Node.
Gets or sets the maximum number of links that may come out of this port. This property is used by LinkingBaseTool.isValidFrom.
The value must be non-negative. The default value is Infinity.
You must set this property on a GraphObject whose portId is non-null, unless the whole Node is acting as a single port, in which case this property should be set on the Node.
Gets or sets how far the end segment of a link coming from this port stops short of the actual port. Positive values are limited by the fromEndSegmentLength or Link.fromEndSegmentLength. Negative values cause the link to extend into the port. The default value is zero.
This property is useful when you have a thick link and a pointy arrowhead. Normally the link Shape extends all the way to the end of the arrowhead. If the link Shape is wide, its edges will be seen behind the arrowhead. By setting this property to a small positive value, the link Shape can end within the body of the arrowhead, leaving only the point of the arrowhead visible at the end of the link.
A negative value for this property can also be useful when you want the link Shape to continue into the port, perhaps because a portion of the port is transparent and you want the link to appear to connect visually with a different point on the node.
The value of Link.fromShortLength, if not NaN, takes precedence over the value at this port when determining the route of the link.
For examples of how to use this property, see Link Connection Points.
You must set this property on a GraphObject whose portId is non-null, unless the whole Node is acting as a single port, in which case this property should be set on the Node.
Gets or sets where a link should connect from this port. The default value is Spot.None, meaning that the link routing must consider the shape of the port and connect at the closest point.
The value of Link.fromSpot, if not Spot.Default, takes precedence over the value at this port when determining the route of the link. A number of the predefined Layouts automatically set Link.fromSpot and Link.toSpot, thereby causing this property and toSpot on the port element to be ignored. Depending on the layout, you may be able to disable that behavior, such as by setting ForceDirectedLayout.setsPortSpots, TreeLayout.setsPortSpot, TreeLayout.setsChildPortSpot, or LayeredDigraphLayout.setsPortSpots to false.
For examples of how to use this property, see Link Connection Points.
You must set this property on a GraphObject whose portId is non-null, unless the whole Node is acting as a single port, in which case this property should be set on the Node.
Gets or sets the fractional distance along the main shape of a "Graduated" Panel at which this kind of tick text should end. The default is 1; the value should range from 0 to 1.
Gets or sets the function to convert from a value along a "Graduated" Panel to a string. The default returns a string representing the value rounded to at most 2 decimals.
The function takes a number argument, a value between Panel.graduatedMin and Panel.graduatedMax, and this TextBlock. The function will return a string, the text that will appear at the value of the argument.
Note that the second argument is the TextBlock, not a particular label that would be rendered at the given value. The function, if supplied, must not have any side-effects.
Gets or sets the function to determine which values along a "Graduated" Panel will be skipped. The default is null and doesn't skip any text labels.
The function takes a number argument, a value between Panel.graduatedMin and Panel.graduatedMax, and this TextBlock. The function will return a boolean, whether the text label will be skipped at the value of the argument.
Note that the second argument is the TextBlock, not a particular label that would be rendered at the given value. The function, if supplied, must not have any side-effects.
since2.0
Gets or sets the fractional distance along the main shape of a "Graduated" Panel at which this text should start. The default is 0; the value should range from 0 to 1.
Gets or sets the desired height of this GraphObject in local coordinates. This just gets or sets the height component of the desiredSize. Default is NaN.
Size can also be constrained by setting minSize and maxSize.
The height does not include any transformation due to scale or angle, nor any pen thickness due to Shape.strokeWidth if this is a Shape. If there is a containing Panel the Panel will determine the actual size.
Gets or sets how frequently this text should be drawn within a "Graduated" Panel, in multiples of the Panel.graduatedTickUnit. The default is 1. Any new value must be a positive integer.
This property determines whether or not this GraphObject's events occur before all other events, including selection. This enables the actionDown, actionMove, actionUp, and actionCancel events, which are all handled by the ActionTool.
This object does not get any mouse/touch events if it is not visible or if it is not pickable.
This property is infrequently used -- typically only when implementing objects that act as buttons or knobs or sliders. The default value is false.
Gets or sets whether or not the text displays multiple lines or embedded newlines. If this is false, all characters including and after the first newline will be omitted. The default is true.
see
ReadonlyisGets whether the TextBlock text is truncated (overflowed) or not. This value is set during a TextBlock's measurement.
As with all read-only properties, using this property as a binding source is unlikely to be useful.
since2.3
see
Gets or sets whether a GraphObject is the "main" object for some types of Panel. Panels that use a "main" object include Panel.Auto, Panel.Spot, and Panel.Link.
Panels that use a "main" object will use the first object that has this property set to true, or else just the first object, if none have the property set.
Do not modify this property once this object is an element of a panel.
Gets or sets whether or not the text has a strikethrough line (line-through). The default is false.
see
Gets or sets whether or not the text is underlined. The default is false.
ReadonlylayerThis read-only property returns the GraphObject's containing Layer, if there is any. A plain GraphObject cannot belong directly to a Layer -- only a Part can belong directly to a Layer.
This property is not settable. Normally one changes which Layer that a GraphObject is in by setting Part.layerName. Adding a Part to a Diagram will automatically add that Part to a Layer in that Diagram based on the layerName.
Gets or sets additional spacing between letters.
The default is '0px'. The value may be negative.
Warning: This feature is unsupported in Safari as of 2025. This may cause some user to experience different spacing and different TextBlock measurement, depending on their browser.
Just like in CSS letter-spacing, this spacing creates trailing space on the last character. If this is undesired, consider adding a negative right margin to the TextBlock.
see
since3.1
ReadonlylineReadonlylineThis read-only property returns the height of a line of text in this TextBlock, not including any spacingAbove or spacingBelow.
This value may be meaningless before the TextBlock is measured.
since2.2
see
Gets or sets the size of empty area around this GraphObject, as a Margin, in the containing Panel coordinates.
Negative values are permitted but may cause overlaps with adjacent
objects in a Panel.
You cannot modify the top or left or right or bottom of the value of this property --
if you want to change the margin you must set this property to a different Margin.
Default margin is Margin(0,0,0,0).
For most uses, increasing a margin will increase the space this GraphObject takes in its containing panel. When an object has a GraphObject.stretch value applied, margins may decrease the size of that object.
The property setter accepts a number instead of a Margin object: providing a
number N will result in using a Margin(N, N, N, N).
The property getter will always return a Margin.
Gets or sets the maximum number of lines that this TextBlock can display.
Value must be a greater than zero whole number or Infinity.
The default is Infinity.
Modifying this value may modify the computed height of the TextBlock. If maxLines is set, the value of lineCount will never be larger than maxLines.
see
Gets or sets the maximum size of this GraphObject in container coordinates (either a Panel or the document). Any new value must be of type Size; NaN values are treated as Infinity. If you want no maximum width or height, use NaN or Infinity.
You cannot modify the width or height of the value of this property -- if you want to change the maxSize you must set this property to a different Size. The default value is Infinity by Infinity. A containing Panel will determine the actual size of this object.
see
ReadonlymeasuredThis read-only property returns the measuredBounds of the GraphObject in container coordinates (either a Panel or the document). This describes the transformed bounds with margins excluded.
You must not modify any of the properties of the Rect that is the value of this property.
As with all read-only properties, using this property as a binding source is unlikely to be useful.
Gets or sets the minimum size of this GraphObject in container coordinates (either a Panel or the document). Any new value must be of type Size; NaN values are treated as 0.
You cannot modify the width or height of the value of this property -- if you want to change the minSize you must set this property to a different Size. The default value is zero by zero. A containing Panel will determine the actual size of this object.
see
Gets or sets the function to execute when the user moves the mouse into this stationary object during a DraggingTool drag; this allows you to provide feedback during a drag based on where it might drop.
If this property value is a function, it is called with an InputEvent, this GraphObject, and any previous GraphObject. The InputEvent.targetObject provides the GraphObject that was found at the mouse point before looking up the visual tree of GraphObject.panels to get to this object. By default this property is null.
Note that for a drag-and-drop that originates in a different diagram, the target diagram's selection collection will not be the parts that are being dragged. Instead the temporary parts being dragged can be found as the source diagram's DraggingTool.copiedParts.
This function is called with Diagram.skipsUndoManager temporarily set to true, so that any changes to GraphObjects are not recorded in the UndoManager. You do not need to start and commit any transaction in this function, because the DraggingTool will be conducting one already. After calling this function the diagram will be updated immediately.
For an example of a mouseDragEnter event handler, see the node template in the Org Chart Editor sample.
Gets or sets the function to execute when the user moves the mouse out of this stationary object during a DraggingTool drag; this allows you to provide feedback during a drag based on where it might drop.
If this property value is a function, it is called with an InputEvent, this GraphObject, and any new GraphObject that the mouse is in. The InputEvent.targetObject provides the GraphObject that was found at the mouse point before looking up the visual tree of GraphObject.panels to get to this object. By default this property is null.
Note that for a drag-and-drop that originates in a different diagram, the target diagram's selection collection will not be the parts that are being dragged. Instead the temporary parts being dragged can be found as the source diagram's DraggingTool.copiedParts.
This function is called with Diagram.skipsUndoManager temporarily set to true, so that any changes to GraphObjects are not recorded in the UndoManager. You do not need to start and commit any transaction in this function, because the DraggingTool will be conducting one already. After calling this function the diagram will be updated immediately.
For an example of a mouseDragLeave event handler, see the node template in the Org Chart Editor sample.
Gets or sets the function to execute when a user drops the selection on this object at the end of a DraggingTool drag; this allows you to customize the behavior when a drop occurs on an object.
If this property value is a function, it is called with an InputEvent, this GraphObject. The InputEvent.targetObject provides the GraphObject that was found at the mouse point before looking up the visual tree of GraphObject.panels to get to this object. The function is called within the transaction performed by the DraggingTool, so you do not need to conduct one. By default this property is null.
For an example of a mouseDrop event handler, see the node template in the Org Chart Editor sample.
Gets or sets the function to execute when the user moves the mouse into this object without holding down any buttons. This property is used by the ToolManager.
If this property value is a function, it is called with an InputEvent, this GraphObject that the mouse is now in, and any previous GraphObject that the mouse was in. The InputEvent.targetObject provides the GraphObject that was found at the mouse point before looking up the visual tree of GraphObject.panels to get to this object. By default this property is null.
This function is called with Diagram.skipsUndoManager temporarily set to true, so that any changes to GraphObjects are not recorded in the UndoManager. You do not need to start and commit any transaction in this function. After calling this function the diagram will be updated immediately.
For example, consider the situation where one wants to display buttons that the user can click whenever the user passes the mouse over a node, and the buttons automatically disappear when the mouse leaves the node. This can be implemented by showing an Adornment holding the buttons.
const nodeContextMenu =
new go.Adornment("Spot",
{ background: "transparent" }).add( // to help detect when the mouse leaves the area
new go.Placeholder(),
new go.Panel("Vertical",
{ alignment: go.Spot.Right, alignmentFocus: go.Spot.Left }).add(
go.GraphObject.build("Button")
.add(new go.TextBlock("Command 1"))
.set({
click: (e, obj) => {
const node = obj.part.adornedPart;
alert("Command 1 on " + node.data.text);
node.removeAdornment("ContextMenuOver");
}
}),
go.GraphObject.build("Button")
.add(new go.TextBlock("Command 2"))
.set({
click: (e, obj) => {
const node = obj.part.adornedPart;
alert("Command 2 on " + node.data.text);
node.removeAdornment("ContextMenuOver");
}
})
)
);
Then in the definition of the Node we can implement a mouseEnter event handler:
myDiagram.nodeTemplate =
new go.Node(...,
{
. . .
mouseEnter: (e, node) => {
nodeContextMenu.adornedObject = node;
nodeContextMenu.mouseLeave = (ev, cm) => {
node.removeAdornment("ContextMenuOver");
}
node.addAdornment("ContextMenuOver", nodeContextMenu);
}
}).add(
// Node elements ...
)
Note how it automatically defines a mouseLeave event handler too. The context menu Adornment is removed either when the mouse leaves the area of the Adornment or when the user executes a button click event handler.
Gets or sets the function to execute when the user holds the mouse still for a while over this object while holding down a button. This property is used by the ToolManager.
If this property value is a function, it is called with an InputEvent. By default this property is null.
If you do provide a function that makes changes to the diagram or to its model, you should do so within a transaction -- call Diagram.startTransaction and Diagram.commitTransaction.
You can control how long the user must wait during a drag with a motionless mouse before a "mouse hold" event occurs, by setting ToolManager.holdDelay. For example:
myDiagram = new go.Diagram("myDiagramDiv",
{ "toolManager.holdDelay": 500 }); // 500 milliseconds
or:
myDiagram.toolManager.holdDelay = 500; // 500 milliseconds
Gets or sets the function to execute when the user holds the mouse still for a while over this object without holding down any buttons. This property is used by the ToolManager.
If this property value is a function, it is called with an InputEvent. By default this property is null.
If you do provide a function that makes changes to the diagram or to its model, you should do so within a transaction -- call Diagram.startTransaction and Diagram.commitTransaction.
You can control how long the user must wait with a motionless mouse before a "mouse hover" event occurs, by setting ToolManager.hoverDelay. For example:
myDiagram = new go.Diagram("myDiagramDiv",
{ "toolManager.hoverDelay": 500 }); // 500 milliseconds
or:
myDiagram.toolManager.hoverDelay = 500; // 500 milliseconds
Gets or sets the function to execute when the user moves the mouse out of this object without holding down any buttons. This property is used by the ToolManager.
If this property value is a function, it is called with an InputEvent, this GraphObject that the mouse has left, and any next GraphObject that the mouse is now in. The InputEvent.targetObject provides the GraphObject that was found at the mouse point before looking up the visual tree of GraphObject.panels to get to this object. By default this property is null.
This function is called with Diagram.skipsUndoManager temporarily set to true, so that any changes to GraphObjects are not recorded in the UndoManager. You do not need to start and commit any transaction in this function. After calling this function the diagram will be updated immediately.
For example, the Flow Chart sample automatically shows and hides the ports as the mouse passes over a node. The node template includes the following settings:
myDiagram.nodeTemplate =
new go.Node(...,
{
. . .
// handle mouse enter/leave events to show/hide the ports
mouseEnter: (e, obj) => showPorts(obj.part, true),
mouseLeave: (e, obj) => showPorts(obj.part, false)
. . .
}).add(
// Node elements ...
)
where the showPorts function is defined to set the visible
property of each of the port elements of the node.
Gets or sets the function to execute when the user moves the mouse over this object without holding down any buttons. This property is used by the ToolManager. This property is infrequently used -- it is more common to implement mouseEnter and mouseLeave functions.
If this property value is a function, it is called with an InputEvent and this GraphObject. The InputEvent.targetObject provides the GraphObject that was found at the mouse point before looking up the visual tree of GraphObject.panels to get to this object. By default this property is null.
This function is called with Diagram.skipsUndoManager temporarily set to true, so that any changes to GraphObjects are not recorded in the UndoManager. You do not need to start and commit any transaction in this function. After calling this function the diagram will be updated immediately.
Gets or sets the name for this object. The default value is the empty string. The name should be unique within a Panel, although if it isn't, it reduces the usefulness of methods such as Panel.findObject.
You must not modify the name of a GraphObject once it is in the visual tree of a Part.
This is frequently needed to identify a particular GraphObject in the visual tree of a Part, for example as the value of the Part.locationObjectName or Part.selectionObjectName properties.
ReadonlynaturalThis read-only property returns the natural bounds of this TextBlock in local coordinates, as determined by its font and text string, and optionally its desiredSize.
Gets or sets the multiplicative opacity for this GraphObject and (if a Panel) all elements. The value must be between 0.0 (fully transparent) and 1.0 (no additional transparency).
Unlike visible, Opacity only affects drawing, it does not cause objects to be resized or remeasured. Opacity settings do not change the shape of the object or exclude it from object-picking (does not change whether any objects are found by the "find..." methods).
This value is multiplicative with any existing transparency, for instance from Layer.opacity or a GraphObject's opacity higher in the visual tree, or from a Brush or image transparency. The default value is 1.
Gets or sets how text that is too long to display should be handled.
Possible values are TextOverflow.Clip and TextOverflow.Ellipsis. For Ellipsis to work, you must constrain the available size of the TextBlock in some way, such as setting wrap to Wrap.None, or limiting the number of lines with maxLines or a height constraint.
With Ellipsis, setting the wrap value to Wrap.BreakAll will allow ellipses to break partial words.
The default value is TextOverflow.Clip.
see
ReadonlypanelThis read-only property returns the GraphObject's containing Panel, or null if this object is not in a Panel.
Although Part inherits from this class, a Part will never belong to a Panel, so this property will always be null for every Node or Link.
This property is not settable. Instead, call Panel.add in order to put a GraphObject in a Panel.
ReadonlypartThis read-only property returns the Part containing this object, if any. The Part will be the root GraphObject in this GraphObject's visual tree.
It is common to refer to the containing Part of a GraphObject in order to refer to the Panel.data to which it is bound.
This property is not settable. If you want this GraphObject to belong to a Part, you will need to add it to a Part, or else add it to some visual tree structure that is added to a Part using Panel.add.
Note that for objects such as buttons that are in Adornments such as tooltips or context menus, this property will return that Adornment, not the Node or Link that is adorned.
If you want to find a Group that contains a Part, use the Part.containingGroup property:
someObj.part.containingGroup
Gets or sets whether or not this GraphObject can be chosen by visual "find" or "hit-test" methods such as Diagram.findObjectAt.
This object does not get any mouse/touch events if it is not visible or if it is not pickable.
The default value is true -- mouse events on this object will be noticed. If this value is false and this object is a Panel, not only is this Panel not "hittable", but all of the elements inside the Panel will be ignored.
Gets or sets an identifier for an object acting as a port on a Node. The default value is null -- this object is not a port.
A value that is the empty string is used by convention to mean the primary (and usually only) port of the node.
If a Node has no named ports, then the Node itself is the sole port.
Note: the only kind of model that can save port information, i.e. portIds that are not an empty string, for links is a GraphLinksModel whose GraphLinksModel.linkFromPortIdProperty and GraphLinksModel.linkToPortIdProperty have been set to name properties on the link data objects.
The value should be unique within the Node. You must not modify this property once this GraphObject is in the visual tree of a Node.
See the Learn page on ports for usage information and examples.
Gets or sets the position of this GraphObject in container coordinates
(either a Panel or the document).
Value must be of type Point.
You cannot modify the x or y of the value of this property --
if you want to change the position you must set this property to a different Point.
Default is Point(NaN, NaN).
For Parts, see also Part.location.
Gets or sets the row of this GraphObject if it is in a Table Panel. The value must be a small non-negative integer. The default is 0.
Gets or sets the number of rows spanned by this GraphObject if it is in a Table Panel. The value must be a small positive integer. The default is 1.
Gets or sets the fractional distance along a segment of a GraphObject that is in a Link. The value should be between zero and one, where zero is at the point at the start of the segment, and where one is at the point at the end of the segment. The default value is zero.
If segmentIndex is set to NaN, the fractional distance will be calculated along the entire link route.
For examples of how to use this property, see Link Labels.
Gets or sets the segment index of a GraphObject that is in a Link. Non-negative numbers count up from zero, which is the first segment, at the "from" end of the Link. Negative numbers count segments from the "to" end of the Link, where -1 means the last segment and -2 means the next-to-last segment. The default value is -Infinity. The value should be an integer or NaN.
Setting this value to NaN means segmentFraction's fractional distance will be calculated along the entire link route. A NaN value also means the Link.midPoint and Link.midAngle will not be used when determining label positions.
If you do not set this property, the Link will choose a place that is approximately at the mid-point of the link's route.
For examples of how to use this property, see Link Labels.
Gets or sets the offset of a GraphObject that is in a Link from a point on a segment or in a Panel.Graduated from a point along the main element. The X component of the Point indicates the distance along the route, with positive values going further toward the "to" end of the link or panel. The Y component of the Point indicates the distance away from the route, with positive values towards the right as seen when facing further towards the "to" end of the link or panel. The value defaults to the Point (0, 0). You cannot modify the x or y of the value of this property -- if you want to change the segmentOffset you must set this property to a different Point.
For labels that are near either end of a link, it may be convenient to set the segmentOffset to Point(NaN, NaN). This causes the offset to be half the width and half the height of the label object.
For examples of how to use this property, see Link Labels.
Gets or sets the orientation of a GraphObject that is in a Link or Panel.Graduated. This controls the automatic rotation of the object by the Link Panel or Graduated Panel. The only accepted values are the Link "Orient..." values of Link and the default value: Orientation.None.
When the value is Orientation.None, the angle of this object is unchanged as the link is routed. Setting this to a value of Orientation.Along will cause routing to set the angle to be the angle of the segment that this object is on. Other values compute the angle somewhat differently. If the value is changed back to Orientation.None, the angle of this object is set to zero.
Note that when this property is not Orientation.None, this property takes precedence over any setting or binding of the angle property. Changes to the angle caused by orientation might not result in Changed events, and any original value for the angle may be lost.
In the case of Graduated Panels, if this value is Orientation.None, Orientation.Along, or Orientation.Upright, any TextBlock label angle will be respected. Depending on this value, the effective TextBlock angle will be either fixed or relative to the slope of the path where it is rendered.
For examples of how to use this property, see Link Labels.
Gets or sets whether or not this GraphObject will be shadowed inside a Part that has Part.isShadowed set to true.
The default is null, which means this GraphObject will obey the default shadow rules (see Part.isShadowed).
A value of true or false will ensure that this part is shadowed or not regardless of the default shadow rules, but this GraphObject's shadowed status will not affect other GraphObjects in the Part.
Typically this property does not need to be set, but you may need to set this value to false on GraphObjects inside a Part that you do not wish to be shadowed.
Gets or sets additional spacing above each line of text. The default is zero. The value may be negative.
This can be useful when you need to adjust the font spacing on custom fonts or monospace fonts to suit your needs.
since2.2
Gets or sets additional spacing below each line of text. The default is zero. The value may be negative.
This can be useful when you need to adjust the font spacing on custom fonts or monospace fonts to suit your needs.
since2.2
Gets or sets the stretch of the GraphObject. This controls whether the width and/or height of this object automatically adjusts to fill the area allotted by the containing Panel.
The only accepted values are listed as constant properties of GraphObject, such as Stretch.None, Stretch.Fill, Stretch.Horizontal, or Stretch.Vertical. The default value is Stretch.Default, which allows the Panel to decide how to treat this object, depending on the type of Panel.
Objects with an angle that are stretched may look incorrect unless the angle is a multiple of 90.
Stretch will have have different effects based upon the Panel containing this object. Elements of:
Gets or sets the Brush or string that describes the stroke (color) of the text that is drawn.
The default value is "black".
Any valid CSS string can specify a solid color, and the Brush
class can be used to specify a gradient or pattern.
More information about the syntax of CSS color strings is available at:
CSS colors (mozilla.org).
Gets or sets the TextBlock's text string. The default is an empty string. The text of a TextBlock, along with the values of font, wrap, isMultiline and sizing restrictions are what naturally determine the size of the TextBlock.
The text in textblocks can include manual line-breaks by using the character escape, \n.
Leading and trailing whitespace is eliminated in each line of TextBlock text.
If editable is set to true, users can edit textblocks with the TextEditingTool.
Gets or sets the alignment location in the TextBlock's given space.
The only possible values are "start", "end", "left", "right", and "center".
Any other value is invalid.
This property is most pertinent when the TextBlock has multiple lines of text, or when the TextBlock is given a size that differs from the text's natural size (such as with desiredSize).
In left-to-right writing systems, "start" and "left" are synonymous, as are "end" and "right".
The default is "start".
Gets or sets the function that is called after the TextBlock's text has been edited by the TextEditingTool.
function(textBlock, previousText, currentText)
The default value is null -- no function is called.
Gets or sets the HTMLInfo that this TextBlock uses as its text editor in the TextEditingTool. If null, the TextBlock will use the default text editor of the TextEditingTool. The default is null. The value should be set to an instance of HTMLInfo. Setting this property might not affect any ongoing text editing operation.
For example usage, see the Custom TextEditingTool Sample.
Gets or sets the predicate that determines whether or not a user-edited string of text is valid. If this is non-null, the predicate is called in addition to any TextEditingTool.textValidation predicate. See TextEditingTool.isValidText for more details.
function(textBlock, oldString, newString)
The default predicate is null, which is equivalent to simply returning true.
The function, if supplied, must not have any side-effects, and must return true or false.
Gets or sets the length of the last segment of a link going to this port. This value is used when the computed "to spot" is not Spot.None. The default value is 10.
The value of Link.toEndSegmentLength, if not NaN, takes precedence over the value at this port when determining the route of the link. This value also limits how short the Link.toShortLength may be drawn.
For examples of how to use this property, see Link End Segment Lengths.
You must set this property on a GraphObject whose portId is non-null, unless the whole Node is acting as a single port, in which case this property should be set on the Node.
Gets or sets whether the user may draw Links to this port. This property is used by LinkingBaseTool.isValidTo.
The default value is null, which indicates that the real value is inherited from the parent Panel, or false if there is no containing panel.
You must set this property on a GraphObject whose portId is non-null, unless the whole Node is acting as a single port, in which case this property should be set on the Node, or unless you are disabling the "linkability" of a particular GraphObject inside a Panel whose toLinkable has been set or bound to true.
Gets or sets whether the user may draw duplicate Links to this port. This property is used by LinkingBaseTool.isValidLink. The default value is false.
You must set this property on a GraphObject whose portId is non-null, unless the whole Node is acting as a single port, in which case this property should be set on the Node.
Gets or sets whether the user may draw Links that connect to this port's Node. This property is used by LinkingBaseTool.isValidLink. The default value is false.
You must set this property on a GraphObject whose portId is non-null, unless the whole Node is acting as a single port, in which case this property should be set on the Node.
Gets or sets the maximum number of links that may go into this port. This property is used by LinkingBaseTool.isValidTo.
The value must be non-negative. The default value is Infinity.
You must set this property on a GraphObject whose portId is non-null, unless the whole Node is acting as a single port, in which case this property should be set on the Node.
This Adornment or HTMLInfo is shown when the mouse hovers over this object. The default value is null, which means no tooltip is shown.
A typical tooltip is defined in the following manner, as taken from the Kitten Monitor sample:
myDiagram.nodeTemplate =
new go.Node(...,
{ // this tooltip shows the name and picture of the kitten
toolTip:
go.GraphObject.build("ToolTip").add(
new go.Panel("Vertical").add(
new go.Picture()
.bind("source", "src", s => return "images/" + s + ".png"),
new go.TextBlock({ margin: 3 })
.bind("text", "key")
)
)
}).add(
// Node elements ...
)
Note that this Adornment depends on having the same data binding as the adorned Part (i.e. the same value for Panel.data).
Tooltips are not copied by copy, so that tooltips may be shared by all instances of a template.
Tooltips are shown after a timed delay given by the ToolManager.hoverDelay. You can change the delay time by:
myDiagram = new go.Diagram("myDiagramDiv",
{ "toolManager.hoverDelay": 500 }); // 500 milliseconds
or:
myDiagram.toolManager.hoverDelay = 500; // 500 milliseconds
Tooltips are normally positioned by ToolManager.positionToolTip. However, if there is a Placeholder in the tooltip, the tooltip (i.e. an Adornment) will be positioned so that the Placeholder is at the same position as this adorned GraphObject.
Replacing this value will not modify or remove any existing tooltip that is being shown for this object.
Read more about tooltips at ToolTips.
Gets or sets how far the end segment of a link going to this port stops short of the actual port. Positive values are limited by the toEndSegmentLength or Link.toEndSegmentLength. Negative values cause the link to extend into the port. The default value is zero.
This property is useful when you have a thick link and a pointy arrowhead. Normally the link Shape extends all the way to the end of the arrowhead. If the link Shape is wide, its edges will be seen behind the arrowhead. By setting this property to a small positive value, the link Shape can end within the body of the arrowhead, leaving only the point of the arrowhead visible at the end of the link.
A negative value for this property can also be useful when you want the link Shape to continue into the port, perhaps because a portion of the port is transparent and you want the link to appear to connect visually with a different point on the node.
The value of Link.toShortLength, if not NaN, takes precedence over the value at this port when determining the route of the link.
For examples of how to use this property, see Link Connection Points.
You must set this property on a GraphObject whose portId is non-null, unless the whole Node is acting as a single port, in which case this property should be set on the Node.
Gets or sets where a link should connect to this port. The default value is Spot.None, meaning that the link routing must consider the shape of the port and connect to the closest point.
The value of Link.toSpot, if not Spot.Default, takes precedence over the value at this port when determining the route of the link. A number of the predefined Layouts automatically set Link.fromSpot and Link.toSpot, thereby causing this property and fromSpot on the port element to be ignored. Depending on the layout, you may be able to disable that behavior, such as by setting ForceDirectedLayout.setsPortSpots, TreeLayout.setsPortSpot, TreeLayout.setsChildPortSpot, or LayeredDigraphLayout.setsPortSpots to false.
For examples of how to use this property, see Link Connection Points.
You must set this property on a GraphObject whose portId is non-null, unless the whole Node is acting as a single port, in which case this property should be set on the Node.
Gets or sets the vertical alignment Spot of this TextBlock, used when the TextBlock has more available vertical space than it needs to draw all lines.
The default value is Spot.Top, which aligns the TextBlock to the top of its available space.
The textAlign is often used along with this property to specify where the should be positioned in its available space.
This does not affect TextBlock coordinates or bounds, it only affects where text is drawn within the given area.
see
Gets or sets whether a GraphObject is visible. The default value is true. A not visible object takes no space in the Panel that it is in. Toggling visibility may cause elements in the visual tree to re-measure and re-arrange. Making a Panel not visible causes all of its elements not to be seen or receive input events. Changing a Panel to become visible causes all of its elements to be seen and be active, unless those elements are themselves not visible.
This object does not get any mouse/touch events if it is not visible or if it is not pickable.
One can have a visible Shape that is not drawn by setting its Shape.fill
and Shape.stroke to null or to "transparent".
Similarly, one can set TextBlock.stroke to null or to "transparent".
It is also possible make a GraphObjects transparent by setting GraphObject.opacity to 0.
Finally, one can make a whole Layer-full of Parts invisible by setting Layer.visible to false.
Use the isVisibleObject predicate to see if this GraphObject is visible and is inside a Panel that is isVisibleObject, and so forth up the chain of panels until reaching the Part.
For Parts, you can call the Part.isVisible predicate to determine if not only the Part is visible but also any containing Group or Link, and whether the Layer it is in is visible.
Gets or sets the desired width of this GraphObject in local coordinates. This just gets or sets the width component of the desiredSize. Default is NaN.
Size can also be constrained by setting minSize and maxSize.
The width does not include any transformation due to scale or angle, nor any pen thickness due to Shape.strokeWidth if this is a Shape. If there is a containing Panel the Panel will determine the actual size.
Gets or sets additional spacing between words.
The default is '0px'. The value may be negative.
Warning: This feature is unsupported in Safari as of 2025. This may cause some user to experience different spacing and different TextBlock measurement, depending on their browser.
since3.1
Gets or sets whether the text should be wrapped if it is too long to fit on one line.
Possible values are Wrap.DesiredSize, Wrap.Fit, Wrap.BreakAll, and Wrap.None.
The default value is Wrap.DesiredSize.
see
This method takes a function that can be used to apply multiple settings, bindings, or Panel.add calls, to different GraphObjects. This is common in initialization. If you are just adding settings, bindings, or GraphObjects to a single GraphObject, you do not need to use this, you can just chain calls to set, bind, and Panel.add instead. This method is mostly useful when setting the same values across multiple GraphObjects or in multiple templates.
For example:
// This can be used by several node templates
// to set multiple properties and bindings on each
function nodeStyle(node) {
node
.set({ background: 'red' })
.bind("location")
.bind("desiredSize", "size", go.Size.parse)
}
// ... in a Node template:
new go.Node("Auto")
.apply(nodeStyle)
.add(
new go.Shape(. . .),
new go.Panel(. . .)
)
// ...rest of Node template
// ... in another Node template:
new go.Node("Vertical", { padding: 5 })
.apply(nodeStyle)
// ...rest of Node template
In version 3.1 we have added the ability to pass arguments to the function. For example:
function shapeStyle(shp, fig, fill) { // FIG and FILL are optional
shp.width = 32;
shp.height = 32;
shp.figure = fig ? fig : 'Diamond';
shp.fill = fill ? fill : 'gray';
shp.strokeWidth = 0;
}
// ... in a template:
new go.Node(. . .) . . .
.add(
. . .
new go.Shape(. . .).apply(shapeStyle),
new go.Shape(. . .).apply(shapeStyle, 'Triangle'),
new go.Shape(. . .).apply(shapeStyle, 'Circle', 'red'),
. . .
)
a function that takes this GraphObject
this GraphObject
since2.2
seeset a type-safe method to set a collection of properties
This method sets a collection of properties according to the property/value pairs on the given Object, or array of Objects, in the same manner as GraphObject.make does when constructing a GraphObject.
This method is used in initialization, but typically you should use set instead, unless you need to attach new properties that do not exist on the GraphObject, or to set sub-properties. New property names must start with an underscore "_" character.
Calling this method is much less efficient than setting properties directly, and does not do compile-time type checking.
new go.Shape()
.bind("fill", "color")
.bind("strokeWidth", "width")
.attach({ // use .attach for untyped property attachments
"_color": "Red"
})
a JavaScript object containing properties to attach, or an array of such objects.
this GraphObject
since2.2
seeAdd a data-binding to this GraphObject for the given property names and optional conversion functions. The added Binding will be of kind Binding.isToData.
Do not add, modify, or remove any Bindings after this GraphObject has been copied.
An example using .bind with the shorthand arguments:
myDiagram.nodeTemplate =
new go.Node("Horizontal")
// a OneWay Binding, from data.loc to Node.location
.bind("location", "loc", go.Point.parse)
// ... rest of the Node template
To get a TwoWay Binding call Binding.makeTwoWay instead.
myDiagram.nodeTemplate =
new go.Node("Horizontal")
// this is now a TwoWay Binding:
.bindTwoWay("location", "loc", go.Point.parse, go.Point.stringify)
// ... rest of the Node template
Read more about Bindings at the Learn page about Data Bindings.
A string naming the target property on this GraphObject. This should not be the empty string. This becomes the value of Binding.targetProperty.
Optionalsourceprop: stringA string naming the source property on the bound data object. If this is the empty string, the whole Panel.data object is used. If this argument is not supplied, the source property is assumed to be the same as the target property. This becomes the value of Binding.sourceProperty.
Optionalconv: TargetConversionAn optional side-effect-free function converting the data property value to the value to set the target property. If the function is null or not supplied, no conversion takes place. This becomes the value of Binding.converter.
Optionalbackconv: BackConversionDeprecated: call bindTwoWay instead.
this GraphObject
since2.2
Add a data-binding of a property on this GraphObject to a property on a binding source object.
Do not add, modify, or remove any Bindings after this GraphObject has been copied.
An example using .bind with the Binding argument:
myDiagram.nodeTemplate =
new go.Part("Horizontal")
.bind(new go.Binding("location", "loc", go.Point.parse).makeTwoWay(go.Point.stringify))
// ...
However, one could achieve the same effect by using a different method:
myDiagram.nodeTemplate =
new go.Part("Horizontal")
.bindTwoWay("location", "loc", go.Point.parse, go.Point.stringify)
// ...
Read more about Bindings at the Learn page about Data Bindings.
this GraphObject
Add a data-binding from the shared Model.modelData object to a property on this GraphObject. We recommend that you not use TwoWay binding for this kind of Binding.isToModel binding.
This is a convenience function for bind that additionally calls Binding.ofModel on the created binding. See the documentation for bind for details.
The use of TwoWay model data bindings is very uncommon. Note that in order to get a TwoWay Binding one must pass a value for the fourth argument to this method. Pass null when you do not want a back-conversion function applied when passing a property value from this target GraphObject to the source data object.
Read more about Bindings at the Learn page about Data Bindings.
A string naming the target property on this GraphObject. This should not be the empty string. This becomes the value of Binding.targetProperty.
Optionalsourceprop: stringA string naming the source property on the bound shared data object. If this is the empty string, the whole Panel.data object is used. If this argument is not supplied, the source property is assumed to be the same as the target property. This becomes the value of Binding.sourceProperty.
Optionalconv: TargetConversionAn optional side-effect-free function converting the data property value to the value to set the target property. If the function is null or not supplied, no conversion takes place. This becomes the value of Binding.converter.
Optionalbackconv: BackConversionAn optional conversion function to convert GraphObject property values back to data values. Note that for TwoWay bindings whenever the target property is modified, the shared data object will be updated. Specifying this modifies the binding to set its Binding.mode to be BindingMode.TwoWay. Passing null produces a TwoWay Binding, but no back-conversion function will be called. Pass undefined, or do not provide an argument here, in order to produce the normal OneWay binding. This becomes the value of Binding.backConverter.
this GraphObject
since3.0
Add a data-binding from a GraphObject property in this GraphObject's binding Panel to a property on this GraphObject. We recommend that you use this kind of Binding.isToObject binding sparingly.
This is a convenience function for bind that additionally calls Binding.ofObject on the created binding.
It passes the param objectSrcname to the Binding.ofObject call.
See the documentation for bind for details.
The use of TwoWay GraphObject bindings is uncommon. Note that in order to get a TwoWay Binding one must pass a value for the fourth argument to this method. Pass null when you do not want a back-conversion function applied when passing a property value from this target GraphObject to the source object.
Read more about Bindings at the Learn page about Data Bindings.
A string naming the target property on this target GraphObject. This should not be the empty string. This becomes the value of Binding.targetProperty.
Optionalsourceprop: stringA string naming the source property on the source GraphObject. If this is the empty string, the result of GraphObject.findBindingPanel is used. If this argument is not supplied, the source property is assumed to be the same as the target property. This becomes the value of Binding.sourceProperty.
Optionalconv: TargetConversionAn optional side-effect-free function converting the data property value to the value to set the target property. If the function is null or not supplied, no conversion takes place. This becomes the value of Binding.converter.
Optionalbackconv: BackConversionAn optional conversion function to convert GraphObject property values back to property values. Passing a not-undefined value modifies the binding to set its Binding.mode to be BindingMode.TwoWay. Pass null if you want the binding to be TwoWay but not to invoke any back-conversion function. Pass undefined, or do not provide an argument in this position, for the normal OneWay binding. This becomes the value of Binding.backConverter.
OptionalobjectSrcname: stringAn optional GraphObject.name used to identify the source GraphObject by calling Panel.findObject. If the value is an empty string or is not supplied, the source binding Panel is used -- the Part or the item Panel. This becomes the value of Binding.sourceName.
this GraphObject
since3.0
This convenience function works like GraphObject.bind, creating a Binding, then also calls Binding.makeTwoWay on it. These are equivalent:
.bind("text", "text", null, null)
.bindTwoWay("text")
As are these:
.bind("text", "someProp", null, null)
.bindTwoWay("text", "someProp")
The first creates a two-way binding because specifying anything for the 4th argument (BackConversion) automatically sets the Binding.mode to be BindingMode.TwoWay. However, it requires specifying the middle arguments, which may not be necessary.
Read more about Bindings at the Learn page about Data Bindings.
A string naming the target property on this GraphObject. This should not be the empty string. This becomes the value of Binding.targetProperty.
Optionalsourceprop: stringA string naming the source property on the bound data object. If this is the empty string, the whole Panel.data object is used. If this argument is not supplied, the source property is assumed to be the same as the target property. This becomes the value of Binding.sourceProperty.
Optionalconv: TargetConversionAn optional side-effect-free function converting the data property value to the value to set the target property. If the function is null or not supplied, no conversion takes place. This becomes the value of Binding.converter.
Optionalbackconv: BackConversionAn optional conversion function to convert GraphObject property values back to data values. Specifying this modifies the binding to set its Binding.mode to be BindingMode.TwoWay. Pass null or undefined in order for no back-conversion function to be called. This becomes the value of Binding.backConverter.
this GraphObject
since3.0
VirtualcopyWalks up the visual tree and returns the first Panel whose Panel.data is bound to data. This can be useful when you need to inspect Panel.data objects.
since2.2
Returns the effective angle that the object is drawn at, in document coordinates, normalized to between 0 and 360.
Basically this adds together all of the rotation declared by this angle and the angles of all of its containing Panels, including the Part.
Returns the Rect in document coordinates for this object's bounds. If this GraphObject is a Part, the rect will be identical to its actualBounds.
Optionalresult: Rectan optional Rect that is modified and returned.
in document coordinates.
since2.0
Returns the Point in document coordinates for a given Spot in this object's bounds or for a Point in local coordinates.
For example, for an instance of a Node like this:
myDiagram.nodeTemplate =
new go.Node("Auto").add(
new go.Shape("RoundedRectangle")
.bind("fill", "color"),
new go.TextBlock({ name: "TB", margin: 3 })
.bind("text", "key")
);
where the Node is positioned at 100, 200,
node.findObject("TB").getDocumentPoint(go.Spot.Center)
could return a Point that is approximately at 122, 213.
in document coordinates.
Returns the total scale that the object is drawn at, in document coordinates.
Basically this multiplies together this scale with the scales of all of its containing Panels, including the Part.
Given a Point in document coordinates, returns a new Point in local coordinates.
For example, if you have a mouse event whose InputEvent.documentPoint is at 122, 213,
and if you have a Node whose position is at 100, 200,
node.getLocalPoint(e.documentPoint) could return a Point that is at 22, 13.
For a GraphObject within the Node named "TB",
node.findObject("TB").getLocalPoint(e.documentPoint)
could return a Point that is at 15.7, 6.7,
if that "TB" object is positioned somewhat inside the bounds of the Node.
The corresponding Point in local coordinates.
This predicate is true if this object is an element, perhaps indirectly, of the given panel.
For example, if this GraphObject is inside a Part but is not itself the Part,
obj.isContainedBy(obj.part) should be true.
true if this object is contained by the given panel, or if it is contained by another panel that is contained by the given panel, to any depth; false if the argument is null or is not a Panel.
This predicate is false if this object is inside any Panel that is not Panel.isEnabled, or if this is itself a disabled panel. This ignores the visible and pickable properties.
This predicate is true if this object is visible and each of its visual containing panels is also visible. This ignores the actual location or appearance (except visibility) of the panel that this object is part of, as well as ignoring all properties of the Layer or Diagram.
For Parts, you can call the Part.isVisible predicate to determine if not only the Part is visible but also any containing Group or Link or Layer.
Set any number of properties on this GraphObject. This is common in initialization. This method can only be used to set existing properties on this object. To attach new properties, or to set properties of elements, use GraphObject.attach.
This method uses TypeScript compile-time type checking, but does no runtime type checking. If you need to set properties without type checking, or attach new properties, use GraphObject.attach.
// Common init for use in many different shapes:
const shapeStyle = (() => { return { background: 'red', strokeWidth: 0 }; })
// Constructor init is equivalent to "set"
// But if you use common init (eg, shapeStyle())
// You may wish to set additional properties via "set"
new go.Shape(shapeStyle())
.bind("fill", "color")
.bind("strokeWidth", "width")
.set({ // more init via set
figure: "RoundedRectangle"
})
this GraphObject
since2.2
This method sets a collection of properties according to the property/value pairs on the given Object, in the same manner as GraphObject.make does when constructing a GraphObject with an argument that is a simple JavaScript Object.
This method is common in initialization, but typically you should use set instead, unless you need to attach new properties, or set sub-properties. New property names must start with an underscore "_" character.
Calling this method is much less efficient than setting properties directly, and does not do compile-time type checking.
If this is a Panel, you can set properties on named elements within the panel by using a name.property syntax for the property name. For example, if a Node has a Picture that is named "ICON" (because its name property has been set to "ICON") and a TextBlock whose name is "TB", one could set properties on the Node and on each of those named elements by:
aNode.setProperties({
background: "red",
"ICON.source": "https://www.example.com/images/alert.jpg",
"TB.font": "bold 12pt sans-serif"
});
At the current time only a single dot is permitted in the property "name". Note that the use of all-upper-case object names is simply a convention.
a plain JavaScript object with various property values to be set on this GraphObject.
this GraphObject
Add a ThemeBinding from a Theme property to a property on this GraphObject.
Example:
new go.TextBlock()
// assigns TextBlock.stroke to the value of theme.colors.text
.theme("stroke", "text")
This calls ThemeManager.findTheme to get a Theme object. Because the target property is "stroke", it will use the Theme's "colors" object, Theme.colors. It then retrieves that object's "text" value, which should be a CSS color string or undefined. Finally it sets the target GraphObject, in this case TextBlock.stroke.
Read more about theming at the Learn page about Themes.
A string naming the target property on the target object. This should not be the empty string.
Optionalsourceprop: stringA string naming the source property on the theme. This should not be the empty string. If this argument is not supplied, the source property is assumed to be the same as the target property.
OptionalthemeSource: string | nullThe theme source object to search for the source property. Supply a property name if the theme property names are in a sub-object of the Object chosen by the targetprop name. See ThemeBinding.themeSource. If this argument is null or not supplied, the empty-string is used.
Optionalconv: TargetConversionAn optional side-effect-free function converting the source property value to the theme property name. If the function is null or not supplied, no conversion takes place.
Optionalthemeconv: TargetConversionAn optional side-effect-free function converting the theme value to the value to set the target property. See ThemeBinding.themeConverter. If the function is null or not supplied, no conversion takes place. This is infrequently used.
this GraphObject
since3.0
Add a ThemeBinding from a data property to a property on this GraphObject. The data property value should be a theme property name. The theme property value will be the value of that property on the theme source object in the Theme.
Example:
new go.TextBlock()
// assigns TextBlock.stroke to the value of theme.colors[data.state]
.themeData("stroke", "state")
It first gets the bound data object's "state" property value, which should be a theme property name. This then calls ThemeManager.findTheme to get a Theme object. Because the target property is "stroke", it will use the Theme's "colors" object, Theme.colors. It then retrieves that object's property value that was named by "state", which should be a CSS color string or undefined. Finally it sets the target GraphObject, in this case TextBlock.stroke.
Note that if the data property value were instead an actual CSS color string, you would not use themeData because you would not be using themes at all, but just call GraphObject.bind to directly assign the color to the TextBlock.stroke property.
This is a convenience function for theme that additionally calls ThemeBinding.ofData on the created binding.
Read more about theming at the Learn page about Themes.
A string naming the target property on the target object. This should not be the empty string.
Optionalsourceprop: stringA string naming the data source property. This should not be the empty string. If this argument is not supplied, the source property is assumed to be the same as the target property.
OptionalthemeSource: string | nullThe theme source object to search for the source property. Supply a property name if the theme property names are in a sub-object of the Object chosen by the targetprop name. See ThemeBinding.themeSource. If this argument is null or not supplied, the empty-string is used.
Optionalconv: TargetConversionAn optional side-effect-free function converting the source property value to the theme property name. If the function is null or not supplied, no conversion takes place.
Optionalthemeconv: TargetConversionAn optional side-effect-free function converting the theme value to the value to set the target property. See ThemeBinding.themeConverter. If the function is null or not supplied, no conversion takes place. This is infrequently used.
this GraphObject
since3.0
Add a ThemeBinding from the shared Model.modelData to a property on this GraphObject.
Example:
new go.TextBlock()
// assigns TextBlock.stroke to the value of theme.colors[model.modelData.state]
.themeModel("stroke", "state")
It first gets the bound data object's "text" property value, which should be a theme property name. This then calls ThemeManager.findTheme to get a Theme object. Because the target property is "stroke", it will use the Theme's "colors" object, Theme.colors. It then retrieves that object's property value that was named by "state", which should be a CSS color string or undefined. Finally it sets the target GraphObject, in this case TextBlock.stroke.
Note that if the data property value were instead an actual CSS color string, you would not use themeModel because you would not be using themes at all, but just call GraphObject.bindModel to directly assign the color to the TextBlock.stroke property.
This is a convenience function for theme that additionally calls Binding.ofModel on the created binding.
Read more about theming at the Learn page about Themes.
A string naming the target property on the target object. This should not be the empty string.
Optionalsourceprop: stringA string naming the shared model data source property. This should not be the empty string. If this argument is not supplied, the source property is assumed to be the same as the target property.
OptionalthemeSource: string | nullThe theme source object to search for the source property. Supply a property name if the theme property names are in a sub-object. See ThemeBinding.themeSource. If this argument is null or not supplied, the empty-string is used.
Optionalconv: TargetConversionAn optional side-effect-free function converting the source property value to the theme property name. If the function is null or not supplied, no conversion takes place.
Optionalthemeconv: TargetConversionAn optional side-effect-free function converting the theme value to the value to set the target property. See ThemeBinding.themeConverter. If the function is null or not supplied, no conversion takes place. This is infrequently used.
this GraphObject
since3.0
Add a ThemeBinding from a GraphObject property to a property on this GraphObject.
Example:
new go.TextBlock()
// assigns TextBlock.stroke to the value of theme.colors[textblock.text]
// where the textblock.name == "TB1"
.themeObject("stroke", "text", null, null, null, "TB1")
It first finds the element named "TB1", and gets its "text" property value, which should be a theme property name. This then calls ThemeManager.findTheme to get a Theme object. Because the target property is "stroke", it will use the Theme's "colors" object, Theme.colors. It then retrieves that object's property that was named by the TextBlock.text property. Finally it sets the target GraphObject, in this case TextBlock.stroke.
Note that if the GraphObject property value were instead an actual CSS color string, you would not use themeObject because you would not be using themes at all, but just call GraphObject.bindObject to directly assign the other element's color to the TextBlock.stroke property.
This is a convenience function for theme that additionally calls Binding.ofObject on the created binding.
It passes the objectSrcname param to the Binding.ofObject call.
This is infrequently used.
Read more about theming at the Learn page about Themes.
A string naming the target property on the target object. This should not be the empty string.
Optionalsourceprop: stringA string naming the GraphObject source property. This should not be the empty string. If this argument is not supplied, the source property is assumed to be the same as the target property.
OptionalthemeSource: string | nullThe theme source object to search for the source property. Supply a property name if the theme property names are in a sub-object of the Object chosen by the targetprop name. See ThemeBinding.themeSource. If this argument is null or not supplied, the empty-string is used.
Optionalconv: TargetConversionAn optional side-effect-free function converting the source property value to the theme property name. If the function is null or not supplied, no conversion takes place.
Optionalthemeconv: TargetConversionAn optional side-effect-free function converting the theme value to the value to set the target property. See ThemeBinding.themeConverter. If the function is null or not supplied, no conversion takes place. This is infrequently used.
OptionalobjectSrcname: string | nullthe GraphObject.name of an element in the visual tree of the bound Panel If not supplied, it uses the binding Panel as the source GraphObject.
this GraphObject
since3.0
Add an AnimationTrigger to this GraphObject for the given property name and optional animation settings.
A string naming the target property to animate. This should not be the empty string.
OptionalanimationSettings: { duration?: number; easing?: EasingFunction; finished?: (animation: Animation) => void }An optional Object describing properties to set on animations created by this AnimationTrigger. See the AnimationTrigger.animationSettings property for detail. If specified, this also sets the AnimationTrigger.startCondition to TriggerStart.Immediate.
OptionalstartCondition: TriggerStartAn optional TriggerStart to set the AnimationTrigger.startCondition property.
this GraphObject
since3.0
Add an AnimationTrigger to this GraphObject.
an AnimationTrigger
this GraphObject
since2.2
StaticbuildThis static function creates an instance that was defined with GraphObject.defineBuilder. Once this is called one can use the name as the first argument for GraphObject.make. Names are case sensitive.
The second is an optional settings configuration object, equivalent to calling GraphObject.set on the new object.
Predefined builder names include: "Button", "TreeExpanderButton", "SubGraphExpanderButton",
"PanelExpanderButton", and "ContextMenuButton".
The implementation of these builders is provided by Buttons.js
in the Extensions directory.
a capitalized name; must not be "" or "None"
Optionalconfig: Partial<T> & ObjectDataa plain JavaScript object with various property values to be set on this GraphObject.
If defined in the builder, the additional arguments that would be passed to GraphObject.takeBuilderArgument
since2.2
This static function creates an instance that was defined with GraphObject.defineBuilder. Once this is called one can use the name as the first argument for GraphObject.make. Names are case sensitive.
The second is an optional settings configuration object, equivalent to calling GraphObject.set on the new object.
Predefined builder names include: "Button", "TreeExpanderButton", "SubGraphExpanderButton",
"PanelExpanderButton", and "ContextMenuButton".
The implementation of these builders is provided by Buttons.js
in the Extensions directory.
a capitalized name; must not be "" or "None"
Optionalconfig: Partial<T> & ObjectDataa plain JavaScript object with various property values to be set on this GraphObject.
If defined in the builder, the additional arguments that would be passed to GraphObject.takeBuilderArgument
since2.2
This static function creates an instance that was defined with GraphObject.defineBuilder. Once this is called one can use the name as the first argument for GraphObject.make. Names are case sensitive.
The second is an optional settings configuration object, equivalent to calling GraphObject.set on the new object.
Predefined builder names include: "Button", "TreeExpanderButton", "SubGraphExpanderButton",
"PanelExpanderButton", and "ContextMenuButton".
The implementation of these builders is provided by Buttons.js
in the Extensions directory.
a capitalized name; must not be "" or "None"
Optionalconfig: Partial<T> & ObjectDataa plain JavaScript object with various property values to be set on this GraphObject.
If defined in the builder, the additional arguments that would be passed to GraphObject.takeBuilderArgument
since2.2
StaticdefineThis static function defines a named function that GraphObject.make or GraphObject.build can use to build objects. Once this is called one can use the name as the first argument for GraphObject.make or GraphObject.build. Names are case sensitive.
The second argument must be a function that returns a newly created object, typically a GraphObject. It is commonplace for that object to be a Panel holding a newly created visual tree of GraphObjects. The function receives as its only argument an Array that is holds all of the arguments that are being passed to GraphObject.make, which it may modify in order to change the arguments that GraphObject.make receives.
You can determine whether or not a builder name has already been defnied by calling the static function GraphObject.isBuilderDefined.
Predefined builder names include: "Button", "TreeExpanderButton", "SubGraphExpanderButton",
"PanelExpanderButton", and "ContextMenuButton".
The implementation of these builders is provided by Buttons.js
in the Extensions directory.
a capitalized name; must not be "" or "None"
that takes an Array of GraphObject.make arguments and returns a new object
StaticgetGets the function that, given the TextBlock and numerical text height, computes the position to draw the baseline of a line of text in all TextBlocks.
By default this is null and default behavior returns (textHeight * 0.75).
This computation affects drawing only, and does not change TextBlock measurement calculations.
since2.0
StaticgetGets the function that, given the TextBlock and numerical text height, computes the position to draw the underline of a line of text in all TextBlocks.
By default this is null and default behavior returns (textHeight * 0.75).
This computation affects drawing only, and does not change TextBlock measurement calculations.
since2.0
StaticisThis static predicate is true if and only if GraphObject.defineBuilder has been called on the given name. Such names can be used as the first argument to the static function GraphObject.build.
since3.1
StaticisThis static predicate returns true if the given font is a valid font. Such a string can be used as the value of font.
since3.0
StaticmakeThis static function builds an object given its class and additional arguments providing initial properties or GraphObjects that become Panel elements.
The first argument must be the class type or the name of a class or the name of a predefined kind of Panel. This function will construct a new instance of that type and use the rest of the arguments to initialize the object. The first argument cannot be a regular Object (such as a GraphObject) that you are trying to initialize; for that you can call setProperties or Diagram.setProperties, although that would be less efficient than setting properties directly.
If an initializer argument is an enumerated value, this tries to set the property that seems most appropriate.
If an initializer argument is a string, this sets a particular property depending on the type of object being built.
If an initializer argument is a particular kind of object, this can add that object to the object being built.
When the initializer argument is a plain JavaScript Object, there are several ways that that object's properties are applied. If the property name is a string with a period inside it, this has a special meaning if the object is a Panel or a Diagram. At the current time only a single period separator is valid syntax for a property string, and it is valid only on Panels and Diagrams.
For Panels, the substring before the period is used as the name passed to Panel.findObject to get the actual object on which to set the property, which is the substring after the period. This is normally useful only on the predefined Panels:
But you can define your own names that GraphObject.make can build by calling the static function GraphObject.defineBuilder.
For Diagrams, the substring before the period is used as the name of a property on the Diagram itself to get the actual object on which to set the property. As a special case, if such a property value does not exist on the Diagram, it looks on the Diagram.toolManager. See some examples below.
Also for Diagrams, and only for Diagrams, if the property name is the name of a DiagramEvent, the property value must be a DiagramEvent listener function, and Diagram.addDiagramListener is called using that DiagramEvent name and that function. Note that all DiagramEvent names are capitalized and do not contain any periods, so there cannot be any name conflicts with any properties on Diagram or ToolManager. Although you can register multiple listeners for the same DiagramEvent names, due to JavaScript limitations those need to be declared using separate JavaScript objects, because JavaScript does not permit duplicate property names in an Object literal.
Furthermore for Diagrams, if the property name is "Changed" or "ModelChanged",
the property value must be a ChangedEvent listener function, which is called with a ChangedEvent argument.
When the property name is "Changed", it calls Diagram.addChangedListener,
notifying about changes to the Diagram or its Layers or GraphObjects.
When the property name is "ModelChanged", it calls Model.addChangedListener on the Diagram.model,
resulting in notifications about changes to the Model or its data.
This is handy because the Diagram.model property setter will automatically call
Model.removeChangedListener on the old model, thereby avoiding any overhead if there are any
more changes to the old model and also avoiding a reference to the listener which might cause garbage collection retention.
It also will call Model.addChangedListener on the new model, helping implement the same behavior with the new model.
If the property name is a number and if the object being constructed is a Brush, the number and value are added to the Brush by calling Brush.addColorStop.
Otherwise the property name is used as a regular property name on the object being built. This tries to do some property name and value checking: when a property is not defined on the object being built, it will signal an error. Many typos can be found this way that would be ignored by JavaScript code.
If the property name begins with an underscore, this will not complain about the property being undefined. Not only is that underscore property set on the object being built, but calls to copy will also copy the values of such named properties to the new objects.
const diagram =
new go.Diagram("myDiagramDiv",
{
// don't initialize some properties until after a new model has been loaded
"InitialLayoutCompleted": loadDiagramProperties,
allowZoom: false, // don't allow the user to change the diagram's scale
"grid.visible": true, // display a background grid for the whole diagram
"grid.gridCellSize": new go.Size(20, 20),
// allow double-click in background to create a new node
"clickCreatingTool.archetypeNodeData": { text: "Node" },
// allow Ctrl-G to call the groupSelection command
"commandHandler.archetypeGroupData":
{ text: "Group", isGroup: true, color: "blue" },
"toolManager.hoverDelay": 100, // how quickly tooltips are shown
// mouse wheel zooms instead of scrolls
"toolManager.mouseWheelBehavior": go.WheelMode.Zoom,
"commandHandler.copiesTree": true, // for the copy command
"commandHandler.deletesTree": true, // for the delete command
"draggingTool.dragsTree": true, // dragging for both move and copy
"draggingTool.isGridSnapEnabled": true,
layout: new go.TreeLayout(
{ angle: 90, sorting: go.TreeLayout.SortingAscending })
});
diagram.nodeTemplate =
new go.Node("Auto") // or go.Panel.Auto
.bindTwoWay("location", "loc", go.Point.parse, go.Point.stringify).add(
new go.Shape("RoundedRectangle",
{
fill: new go.Brush("Linear", { 0: "#FEC901", 1: "#FEA200" }),
stroke: "gray",
strokeWidth: 2,
strokeDashArray: [3, 3]
}),
new go.TextBlock(
{ margin: 5, font: "bold 12pt sans-serif" })
.bind("text", "key")
);
See the Learn page on building objects for usage information and examples of GraphObject.make.
a class function or the name of a class in the go namespace,
or one of several predefined kinds of Panels: "Button", "TreeExpanderButton",
"SubGraphExpanderButton", or "ContextMenuButton".
zero or more values that initialize the new object, typically an Object with properties whose values are set on the new object, or a JavaScript Array with additional initializer arguments, or a GraphObject that is added to a Panel, or a Binding for one of the new object's properties, or a constant value as the initial value of a single property of the new object that is recognized to take that value, or a string that is used as the value of a commonly set property.
This static function builds an object given its class and additional arguments providing initial properties or GraphObjects that become Panel elements.
The first argument must be the class type or the name of a class or the name of a predefined kind of Panel. This function will construct a new instance of that type and use the rest of the arguments to initialize the object. The first argument cannot be a regular Object (such as a GraphObject) that you are trying to initialize; for that you can call setProperties or Diagram.setProperties, although that would be less efficient than setting properties directly.
If an initializer argument is an enumerated value, this tries to set the property that seems most appropriate.
If an initializer argument is a string, this sets a particular property depending on the type of object being built.
If an initializer argument is a particular kind of object, this can add that object to the object being built.
When the initializer argument is a plain JavaScript Object, there are several ways that that object's properties are applied. If the property name is a string with a period inside it, this has a special meaning if the object is a Panel or a Diagram. At the current time only a single period separator is valid syntax for a property string, and it is valid only on Panels and Diagrams.
For Panels, the substring before the period is used as the name passed to Panel.findObject to get the actual object on which to set the property, which is the substring after the period. This is normally useful only on the predefined Panels:
But you can define your own names that GraphObject.make can build by calling the static function GraphObject.defineBuilder.
For Diagrams, the substring before the period is used as the name of a property on the Diagram itself to get the actual object on which to set the property. As a special case, if such a property value does not exist on the Diagram, it looks on the Diagram.toolManager. See some examples below.
Also for Diagrams, and only for Diagrams, if the property name is the name of a DiagramEvent, the property value must be a DiagramEvent listener function, and Diagram.addDiagramListener is called using that DiagramEvent name and that function. Note that all DiagramEvent names are capitalized and do not contain any periods, so there cannot be any name conflicts with any properties on Diagram or ToolManager. Although you can register multiple listeners for the same DiagramEvent names, due to JavaScript limitations those need to be declared using separate JavaScript objects, because JavaScript does not permit duplicate property names in an Object literal.
Furthermore for Diagrams, if the property name is "Changed" or "ModelChanged",
the property value must be a ChangedEvent listener function, which is called with a ChangedEvent argument.
When the property name is "Changed", it calls Diagram.addChangedListener,
notifying about changes to the Diagram or its Layers or GraphObjects.
When the property name is "ModelChanged", it calls Model.addChangedListener on the Diagram.model,
resulting in notifications about changes to the Model or its data.
This is handy because the Diagram.model property setter will automatically call
Model.removeChangedListener on the old model, thereby avoiding any overhead if there are any
more changes to the old model and also avoiding a reference to the listener which might cause garbage collection retention.
It also will call Model.addChangedListener on the new model, helping implement the same behavior with the new model.
If the property name is a number and if the object being constructed is a Brush, the number and value are added to the Brush by calling Brush.addColorStop.
Otherwise the property name is used as a regular property name on the object being built. This tries to do some property name and value checking: when a property is not defined on the object being built, it will signal an error. Many typos can be found this way that would be ignored by JavaScript code.
If the property name begins with an underscore, this will not complain about the property being undefined. Not only is that underscore property set on the object being built, but calls to copy will also copy the values of such named properties to the new objects.
const diagram =
new go.Diagram("myDiagramDiv",
{
// don't initialize some properties until after a new model has been loaded
"InitialLayoutCompleted": loadDiagramProperties,
allowZoom: false, // don't allow the user to change the diagram's scale
"grid.visible": true, // display a background grid for the whole diagram
"grid.gridCellSize": new go.Size(20, 20),
// allow double-click in background to create a new node
"clickCreatingTool.archetypeNodeData": { text: "Node" },
// allow Ctrl-G to call the groupSelection command
"commandHandler.archetypeGroupData":
{ text: "Group", isGroup: true, color: "blue" },
"toolManager.hoverDelay": 100, // how quickly tooltips are shown
// mouse wheel zooms instead of scrolls
"toolManager.mouseWheelBehavior": go.WheelMode.Zoom,
"commandHandler.copiesTree": true, // for the copy command
"commandHandler.deletesTree": true, // for the delete command
"draggingTool.dragsTree": true, // dragging for both move and copy
"draggingTool.isGridSnapEnabled": true,
layout: new go.TreeLayout(
{ angle: 90, sorting: go.TreeLayout.SortingAscending })
});
diagram.nodeTemplate =
new go.Node("Auto") // or go.Panel.Auto
.bindTwoWay("location", "loc", go.Point.parse, go.Point.stringify).add(
new go.Shape("RoundedRectangle",
{
fill: new go.Brush("Linear", { 0: "#FEC901", 1: "#FEA200" }),
stroke: "gray",
strokeWidth: 2,
strokeDashArray: [3, 3]
}),
new go.TextBlock(
{ margin: 5, font: "bold 12pt sans-serif" })
.bind("text", "key")
);
See the Learn page on building objects for usage information and examples of GraphObject.make.
a class function or the name of a class in the go namespace,
or one of several predefined kinds of Panels: "Button", "TreeExpanderButton",
"SubGraphExpanderButton", or "ContextMenuButton".
zero or more values that initialize the new object, typically an Object with properties whose values are set on the new object, or a JavaScript Array with additional initializer arguments, or a GraphObject that is added to a Panel, or a Binding for one of the new object's properties, or a constant value as the initial value of a single property of the new object that is recognized to take that value, or a string that is used as the value of a commonly set property.
This static function builds an object given its class and additional arguments providing initial properties or GraphObjects that become Panel elements.
The first argument must be the class type or the name of a class or the name of a predefined kind of Panel. This function will construct a new instance of that type and use the rest of the arguments to initialize the object. The first argument cannot be a regular Object (such as a GraphObject) that you are trying to initialize; for that you can call setProperties or Diagram.setProperties, although that would be less efficient than setting properties directly.
If an initializer argument is an enumerated value, this tries to set the property that seems most appropriate.
If an initializer argument is a string, this sets a particular property depending on the type of object being built.
If an initializer argument is a particular kind of object, this can add that object to the object being built.
When the initializer argument is a plain JavaScript Object, there are several ways that that object's properties are applied. If the property name is a string with a period inside it, this has a special meaning if the object is a Panel or a Diagram. At the current time only a single period separator is valid syntax for a property string, and it is valid only on Panels and Diagrams.
For Panels, the substring before the period is used as the name passed to Panel.findObject to get the actual object on which to set the property, which is the substring after the period. This is normally useful only on the predefined Panels:
But you can define your own names that GraphObject.make can build by calling the static function GraphObject.defineBuilder.
For Diagrams, the substring before the period is used as the name of a property on the Diagram itself to get the actual object on which to set the property. As a special case, if such a property value does not exist on the Diagram, it looks on the Diagram.toolManager. See some examples below.
Also for Diagrams, and only for Diagrams, if the property name is the name of a DiagramEvent, the property value must be a DiagramEvent listener function, and Diagram.addDiagramListener is called using that DiagramEvent name and that function. Note that all DiagramEvent names are capitalized and do not contain any periods, so there cannot be any name conflicts with any properties on Diagram or ToolManager. Although you can register multiple listeners for the same DiagramEvent names, due to JavaScript limitations those need to be declared using separate JavaScript objects, because JavaScript does not permit duplicate property names in an Object literal.
Furthermore for Diagrams, if the property name is "Changed" or "ModelChanged",
the property value must be a ChangedEvent listener function, which is called with a ChangedEvent argument.
When the property name is "Changed", it calls Diagram.addChangedListener,
notifying about changes to the Diagram or its Layers or GraphObjects.
When the property name is "ModelChanged", it calls Model.addChangedListener on the Diagram.model,
resulting in notifications about changes to the Model or its data.
This is handy because the Diagram.model property setter will automatically call
Model.removeChangedListener on the old model, thereby avoiding any overhead if there are any
more changes to the old model and also avoiding a reference to the listener which might cause garbage collection retention.
It also will call Model.addChangedListener on the new model, helping implement the same behavior with the new model.
If the property name is a number and if the object being constructed is a Brush, the number and value are added to the Brush by calling Brush.addColorStop.
Otherwise the property name is used as a regular property name on the object being built. This tries to do some property name and value checking: when a property is not defined on the object being built, it will signal an error. Many typos can be found this way that would be ignored by JavaScript code.
If the property name begins with an underscore, this will not complain about the property being undefined. Not only is that underscore property set on the object being built, but calls to copy will also copy the values of such named properties to the new objects.
const diagram =
new go.Diagram("myDiagramDiv",
{
// don't initialize some properties until after a new model has been loaded
"InitialLayoutCompleted": loadDiagramProperties,
allowZoom: false, // don't allow the user to change the diagram's scale
"grid.visible": true, // display a background grid for the whole diagram
"grid.gridCellSize": new go.Size(20, 20),
// allow double-click in background to create a new node
"clickCreatingTool.archetypeNodeData": { text: "Node" },
// allow Ctrl-G to call the groupSelection command
"commandHandler.archetypeGroupData":
{ text: "Group", isGroup: true, color: "blue" },
"toolManager.hoverDelay": 100, // how quickly tooltips are shown
// mouse wheel zooms instead of scrolls
"toolManager.mouseWheelBehavior": go.WheelMode.Zoom,
"commandHandler.copiesTree": true, // for the copy command
"commandHandler.deletesTree": true, // for the delete command
"draggingTool.dragsTree": true, // dragging for both move and copy
"draggingTool.isGridSnapEnabled": true,
layout: new go.TreeLayout(
{ angle: 90, sorting: go.TreeLayout.SortingAscending })
});
diagram.nodeTemplate =
new go.Node("Auto") // or go.Panel.Auto
.bindTwoWay("location", "loc", go.Point.parse, go.Point.stringify).add(
new go.Shape("RoundedRectangle",
{
fill: new go.Brush("Linear", { 0: "#FEC901", 1: "#FEA200" }),
stroke: "gray",
strokeWidth: 2,
strokeDashArray: [3, 3]
}),
new go.TextBlock(
{ margin: 5, font: "bold 12pt sans-serif" })
.bind("text", "key")
);
See the Learn page on building objects for usage information and examples of GraphObject.make.
a class function or the name of a class in the go namespace,
or one of several predefined kinds of Panels: "Button", "TreeExpanderButton",
"SubGraphExpanderButton", or "ContextMenuButton".
zero or more values that initialize the new object, typically an Object with properties whose values are set on the new object, or a JavaScript Array with additional initializer arguments, or a GraphObject that is added to a Panel, or a Binding for one of the new object's properties, or a constant value as the initial value of a single property of the new object that is recognized to take that value, or a string that is used as the value of a commonly set property.
This static function builds an object given its class and additional arguments providing initial properties or GraphObjects that become Panel elements.
The first argument must be the class type or the name of a class or the name of a predefined kind of Panel. This function will construct a new instance of that type and use the rest of the arguments to initialize the object. The first argument cannot be a regular Object (such as a GraphObject) that you are trying to initialize; for that you can call setProperties or Diagram.setProperties, although that would be less efficient than setting properties directly.
If an initializer argument is an enumerated value, this tries to set the property that seems most appropriate.
If an initializer argument is a string, this sets a particular property depending on the type of object being built.
If an initializer argument is a particular kind of object, this can add that object to the object being built.
When the initializer argument is a plain JavaScript Object, there are several ways that that object's properties are applied. If the property name is a string with a period inside it, this has a special meaning if the object is a Panel or a Diagram. At the current time only a single period separator is valid syntax for a property string, and it is valid only on Panels and Diagrams.
For Panels, the substring before the period is used as the name passed to Panel.findObject to get the actual object on which to set the property, which is the substring after the period. This is normally useful only on the predefined Panels:
But you can define your own names that GraphObject.make can build by calling the static function GraphObject.defineBuilder.
For Diagrams, the substring before the period is used as the name of a property on the Diagram itself to get the actual object on which to set the property. As a special case, if such a property value does not exist on the Diagram, it looks on the Diagram.toolManager. See some examples below.
Also for Diagrams, and only for Diagrams, if the property name is the name of a DiagramEvent, the property value must be a DiagramEvent listener function, and Diagram.addDiagramListener is called using that DiagramEvent name and that function. Note that all DiagramEvent names are capitalized and do not contain any periods, so there cannot be any name conflicts with any properties on Diagram or ToolManager. Although you can register multiple listeners for the same DiagramEvent names, due to JavaScript limitations those need to be declared using separate JavaScript objects, because JavaScript does not permit duplicate property names in an Object literal.
Furthermore for Diagrams, if the property name is "Changed" or "ModelChanged",
the property value must be a ChangedEvent listener function, which is called with a ChangedEvent argument.
When the property name is "Changed", it calls Diagram.addChangedListener,
notifying about changes to the Diagram or its Layers or GraphObjects.
When the property name is "ModelChanged", it calls Model.addChangedListener on the Diagram.model,
resulting in notifications about changes to the Model or its data.
This is handy because the Diagram.model property setter will automatically call
Model.removeChangedListener on the old model, thereby avoiding any overhead if there are any
more changes to the old model and also avoiding a reference to the listener which might cause garbage collection retention.
It also will call Model.addChangedListener on the new model, helping implement the same behavior with the new model.
If the property name is a number and if the object being constructed is a Brush, the number and value are added to the Brush by calling Brush.addColorStop.
Otherwise the property name is used as a regular property name on the object being built. This tries to do some property name and value checking: when a property is not defined on the object being built, it will signal an error. Many typos can be found this way that would be ignored by JavaScript code.
If the property name begins with an underscore, this will not complain about the property being undefined. Not only is that underscore property set on the object being built, but calls to copy will also copy the values of such named properties to the new objects.
const diagram =
new go.Diagram("myDiagramDiv",
{
// don't initialize some properties until after a new model has been loaded
"InitialLayoutCompleted": loadDiagramProperties,
allowZoom: false, // don't allow the user to change the diagram's scale
"grid.visible": true, // display a background grid for the whole diagram
"grid.gridCellSize": new go.Size(20, 20),
// allow double-click in background to create a new node
"clickCreatingTool.archetypeNodeData": { text: "Node" },
// allow Ctrl-G to call the groupSelection command
"commandHandler.archetypeGroupData":
{ text: "Group", isGroup: true, color: "blue" },
"toolManager.hoverDelay": 100, // how quickly tooltips are shown
// mouse wheel zooms instead of scrolls
"toolManager.mouseWheelBehavior": go.WheelMode.Zoom,
"commandHandler.copiesTree": true, // for the copy command
"commandHandler.deletesTree": true, // for the delete command
"draggingTool.dragsTree": true, // dragging for both move and copy
"draggingTool.isGridSnapEnabled": true,
layout: new go.TreeLayout(
{ angle: 90, sorting: go.TreeLayout.SortingAscending })
});
diagram.nodeTemplate =
new go.Node("Auto") // or go.Panel.Auto
.bindTwoWay("location", "loc", go.Point.parse, go.Point.stringify).add(
new go.Shape("RoundedRectangle",
{
fill: new go.Brush("Linear", { 0: "#FEC901", 1: "#FEA200" }),
stroke: "gray",
strokeWidth: 2,
strokeDashArray: [3, 3]
}),
new go.TextBlock(
{ margin: 5, font: "bold 12pt sans-serif" })
.bind("text", "key")
);
See the Learn page on building objects for usage information and examples of GraphObject.make.
a class function or the name of a class in the go namespace,
or one of several predefined kinds of Panels: "Button", "TreeExpanderButton",
"SubGraphExpanderButton", or "ContextMenuButton".
zero or more values that initialize the new object, typically an Object with properties whose values are set on the new object, or a JavaScript Array with additional initializer arguments, or a GraphObject that is added to a Panel, or a Binding for one of the new object's properties, or a constant value as the initial value of a single property of the new object that is recognized to take that value, or a string that is used as the value of a commonly set property.
StaticsetSets the function that, given the TextBlock and numerical text height, computes the position to draw the baseline of a line of text in all TextBlocks.
This computation affects drawing only, and does not change TextBlock measurement calculations.
It is expected this method will be called before or during initialization of any Diagram.
Diagrams will not redraw when this method has been called,
and you should call Diagram.redraw() if you are calling this method outside of your initialization.
since2.0
StaticsetSets the function that, given the TextBlock and numerical text height, computes the position to draw the underline of a line of text in all TextBlocks.
This computation affects drawing only, and does not change TextBlock measurement calculations.
It is expected this method will be called before or during initialization of any Diagram.
Diagrams will not redraw when this method has been called,
and you should call Diagram.redraw() if you are calling this method outside of your initialization.
since2.0
StatictakeThis static function returns the first argument from the arguments array passed to a GraphObject.defineBuilder function by GraphObject.make. By default this requires the first argument to be a string, but you can provide a predicate to determine whether the argument is suitable.
the arguments Array passed to the builder function; this may be modified if an acceptable argument is found and returned
Optionaldefval: anythe default value to return if the argument is optional and not present as the first argument; otherwise throw an error when the argument is not there
Optionalpred: ((a: any) => boolean) | nulla predicate to determine the acceptability of the argument; the default predicate checks whether the argument is a string
Static ReadonlyDefaultdeprecated
Static ReadonlyFilldeprecated
Static ReadonlyFlipdeprecatedSee Flip.Both.
Static ReadonlyFlipdeprecatedSee Flip.Horizontal.
Static ReadonlyFlipdeprecatedSee Flip.Vertical.
Static ReadonlyFormatdeprecatedSee TextFormat.None.
Static ReadonlyFormatdeprecatedSee TextFormat.Trim.
StaticHorizontaldeprecatedSee Stretch.Horizontal.
Static ReadonlyNonedeprecatedSee Wrap.None.
Static ReadonlyOverflowdeprecatedSee TextOverflow.Clip.
Static ReadonlyOverflowdeprecated
Static ReadonlyUniformdeprecatedSee GeometryStretch.Uniform, ImageStretch.Uniform, ViewboxStretch.Uniform.
Static ReadonlyUniformdeprecatedSee ImageStretch.UniformToFill, ViewboxStretch.UniformToFill.
StaticVerticaldeprecatedSee Stretch.Vertical.
Static ReadonlyWrapdeprecatedSee Wrap.BreakAll.
Static ReadonlyWrapdeprecatedSee Wrap.DesiredSize.
Static ReadonlyWrapdeprecatedSee Wrap.Fit.
A TextBlock is a GraphObject that displays a text string in a given font.
The size and appearance of the text is specified by font, which takes a well-formed CSS string as its value. The order of the CSS properties given is important for cross-browser compatibility, and should be given in this order:
"font-style font-variant font-weight font-size font-family"
For example, "Italic small-caps bold 32px Georgia, Serif" is a valid font string using every CSS font property. Note that not all browsers may support every property.
Text is drawn using the stroke brush, which may be any CSS color string or a Brush.
Some created TextBlocks:
TextBlocks typically receive a natural size based on their text and font strings, but often a width is given in order to cause the text to wrap at a certain place. In order for wrapping to occur, the wrap property must not be Wrap.None.
TextBlocks can be edited by users using the TextEditingTool. The HTMLInfo that a given TextBlock uses as its text editor can be customized by setting the textEditor property. For an example of custom text editing tool use, see the Custom TextEditingTool Sample.
For examples of TextBlock possibilities and functionality, see the Learn page on TextBlocks.