Changes for 2.2.21

• Improved Link.makeGeometry so that overrides do not need to test for situations where a Link has fewer than two points.
• Improved shadows when Diagram and Part are scaled.

Changes for 2.2.20

• Improved LinkingTool.doActivate to assign the location of the LinkingBaseTool.temporaryToNode (or the LinkingBaseTool.temporaryFromNode, if drawing a link in the reverse direction) so as to avoid momentarily seeing where the temporary node had been the last time the user tried to draw a new link.
• Corrected functionality when a browser cancels a Pointer event (for instance when the browser is minimized during ongoing Pointer events).
• Corrected GraphObject.mouseLeave sometimes not getting called when the user's pointer leaves the Diagram.
• Fixed iOS Safari text highlighting when dragging Pointer events out of a Diagram.
• Fixed a regression from 2.2.18 where link JumpOvers might cause "Change not within a transaction" warnings on model load.

Changes for 2.2.19

• Event fix for some platforms that reimplement DOM functionality (Polymer and Salesforce Aura components).
• Graduated panels no longer display shadows on Shape and TextBlock elements when those elements explicitly disable shadows with GraphObject.shadowVisible.

Changes for 2.2.18

• Fix for some initialization animations which could set Part.location incorrectly.
• Fixed operation of the LinkShiftingTool extension when the mouse is inside the connected node.
• The TypeScript extensions are now compiled with options "noImplicitOverride": true, "noUnusedLocals": true.
• Fix since 2.2.0: Link bounds now always contain all JumpOvers.
• Fix since 2.2.0: When a Diagram.autoScale is applied, dragging Parts outside of the viewport now reliably triggers a redraw.

Changes for 2.2.17

• Internal performance optimizations.
• LinkLabelDraggingTool extension now supports labels with GraphObject.segmentIndex of NaN.
• Static Brush functions will no longer trigger Chrome's warning about willReadOnly.

Changes for 2.2.16

• Fixed a regression from 2.2.13 that caused chained animations (calls to an Animation.start inside annother Animation's Animation.finished) to fail.
• Fixed Picture.successFunction/Picture.errorFunction not firing when a Part with a Picture is copied, and that Picture's Picture.source is not data-bound.
• Fixed a regression from 2.1.50 where setting a Picture.source binding and a default value would fail to use the default value, if there was no data to bind.

Changes for 2.2.15

• Fixed non-Path Geometry copies not to have a null value for Geometry.figures.
• Improved the calculation of the midpoint of Bezier curve Links that have exactly three points in their route.
• Fixed some empty Table panels causing an exception.
• Loading the GoJS library twice is now a console warning, instead of an error.

Changes for 2.2.14

• Diagram Layouts with Layout.isRealtime set to true will no longer attempt real-time layouts during the DraggingTool operation.
• Graduated Panels now deal with highly precise floating point numbers more accurately.

Changes for 2.2.13

• Fixed asynchronous model loading which might intermittently fail to perform AvoidsNodes routing.
• Enhanced the ArrangingLayout extension to support placing the side nodes about the middle of the side, by supporting values such as go.Spot.Bottom for the ArrangingLayout.side property.
• Improved the "HyperlinkText" builder extension so that it works by default in Adornments and other Parts that are in temporary layers, by setting GraphObject.isActionable to true.
• Table panel separator strokes no longer draw if a row or column is empty of visual elements, and will not draw a separator above the first-rendered row/col.

Changes for 2.2.12

• We have been optimizing the space used by GraphObjects. The heap used by typical large diagrams now occupies about 10% less space. Creating copies of a lot of nodes and links may be a bit faster now too.
• Fixed the new PanelLayoutFlow extension so that multiple "Flow" panels can coexist in the same panel.
• Improved GenogramLayout in the Genogram sample to support a horizontal direction as well as the standard vertical direction.
• Improved the Selectable Fields and Selectable Ports samples so that clicking on fields or ports within a node respects the Control and Shift modifiers to toggle or add to the collection of selected fields or ports.
• Fixed object picking (Diagram.findObject, GraphObject.containsPoint, etc) for Shapes with a GraphObject.background.
• The Group.layout property setter now checks to make sure that the new layout is not also the value of Diagram.layout.

Changes for 2.2.11

• Like the DraggingTool in v2.2.0, LinkReshapingTool, ResizingTool, and RotatingTool now optimize transactions to reduce memory usage by only saving the first and last changes for each property of each object in the transaction. This can be changed by overriding stopTransaction on the respective tool.
• Shape.graduatedSkip, TextBlock.graduatedSkip, and TextBlock.graduatedFunction now take a second argument, the Shape or TextBlock.
• Graduated Panels now correctly draw ticks/labels at very large Panel.graduatedMax values.
• The AMD define statement has been removed from the module version of the library (go.mjs, go-module.js, go-debug-module.js)
• The DraggingTool, when dragging a Link (DraggingTool.draggedLink), now passes that link as the RelinkingTool.originalLink so that link validation predicates are passed that link.
• Disconnected links now support setting Part.locationSpot.

Changes for 2.2.10

• Graduated panels now draw all tick marks specifying a Shape.graduatedSkip/TextBlock.graduatedSkip function, even when they could be very close together.
• Drawing fixes on very zoomed-out graphs.
• Multiple orthogonal links between identical nodes side-by-side are now drawn without crossings. This fixes a regression from 2.1.51.

If you are upgrading from 2.1 to 2.2, be sure to get a new license key. You must do this on every major.minor change, such as going from 2.1 to 2.2 or 2.3. You do not need a new key for point (2.2.x) releases.

Changes for 2.2.9

• Fixed a regression from 2.2.8 with Table Panel when tables are empty (including tables in Node templates).

Changes for 2.2.8

• Improved Table Panel measuring when using TableRows and TableColumns in sparsely populated tables.
• Improved Table Panel arranging of items that span several rows or columns, when those rows or columns do not all exist.
• Animation fixes when AnimationTriggers execute during a drag.
• Improved accuracy of tick angles along curves in Graduated panels.
• Fix for two-way bindings on Part.location when undoing.
• Calls to Diagram.makeImage and Diagram.makeImageData no longer throw exceptions when attempting to render "broken" images.

If you are upgrading from 2.1 to 2.2, be sure to get a new license key. You must do this on every major.minor change, such as going from 2.1 to 2.2 or 2.3. You do not need a new key for point (2.2.x) releases.

Changes for 2.2.8

• Improved Table Panel measuring when using TableRows and TableColumns in sparsely populated tables.
• Improved Table Panel arranging of items that span several rows or columns, when those rows or columns do not all exist.
• Animation fixes when AnimationTriggers execute during a drag.
• Improved accuracy of tick angles along curves in Graduated panels.
• Fix for two-way bindings on Part.location when undoing.
• Calls to Diagram.makeImage and Diagram.makeImageData no longer throw exceptions when attempting to render "broken" images.

If you are upgrading from 2.1 to 2.2, be sure to get a new license key. You must do this on every major.minor change, such as going from 2.1 to 2.2 or 2.3. You do not need a new key for point (2.2.x) releases.

Changes for 2.2.7

• Nested or space-constrained Table Panels apportion space more correctly when some Table elements are stretched and other rows/columns have their width or height set.
• Improved the ScrollingTable extension to include a scrollbar "thumb".

Changes for 2.2.6

• Improvements in gesture handling for iPad + keyboard combinations.
• Made improvements and added features to the Gantt and Donut Charts samples.
• Drag and drop from a Diagram into empty page space no longer throws an error (regression in 2.2.4).
• Data Inspector, when multipleSelection option is true, now clears the properties fields when the Diagram.selection is empty.

If you are upgrading from 2.1 to 2.2, be sure to get a new license key. You must do this on every major.minor change, such as going from 2.1 to 2.2 or 2.3. You do not need a new key for point (2.2.x) releases.

Changes for 2.2.5

• Drag and drop across Diagrams fixed on touch devices (regression in 2.2.4 for non Shadow DOM environments).
• Module versions of the library release/go.mjs and release/go-module.js now export go as the default export.

If you are upgrading from 2.1 to 2.2, be sure to get a new license key. You must do this on every major.minor change, such as going from 2.1 to 2.2 or 2.3. You do not need a new key for point (2.2.x) releases.

Changes for 2.2.4

• Allow AnimationTriggers to run during Tool operation. Previously, Animation Triggers would not run if a Tool was active, which prevented some tools such as LinkingTool from starting animations during their events.
• Fixed a regression since 2.2.0: Drag and drop in Shadow DOM environments such as Angular now correctly identify the target Diagram (for dropping from Palettes, for instance).
• Diagram.useDOM and Diagram.isUsingDOM were incorrectly minified, and now have their names properly exposed.

Changes for 2.2.3

• Fixed Spot Panels erroneously giving incorrect sizing information to its elements if a previous element had a stretch.
• Improved LayeredDigraphLayout routing of Bezier curve links to reduce crossing over nodes.
• Fixed optimization (in 2.0.0) of Panel.rebuildItemElements when item template(s) may have changed.
• The package.json now specifies "module": "release/go-module.js"

If you are upgrading from 2.1 to 2.2, be sure to get a new license key. You must do this on every major.minor change, such as going from 2.1 to 2.2 or 2.3. You do not need a new key for point (2.2.x) releases.

Changes for 2.2.2

• Added init optional argument to Brushconstructor.
• Stopped tap-hold on some versions of iOS Safari from selecting text.
• Improvements for licensing Electron apps.

Changes for 2.2 are here

If you are upgrading from 2.1 to 2.2, be sure to get a new license key. You must do this on every major.minor change, such as going from 2.1 to 2.2 or 2.3. You do not need a new key for point (2.2.x) releases.

Changes for 2.2.1

• Added rounded corners to the BalloonLink extension, controlled by the new property BalloonLink.corner. Improved BalloonLink's implementation of BalloonLink.base.
• Fixed licensing issues when using Windows high contrast mode, due to changes in Chrome and Edge.
• Added init optional argument to Layer and Animation constructors. Animation.start and Animation.stop now return this.

See the full 2.2 changelog here.

GoJS 2.2

GoJS 2.2 introduces a number of properties and methods for convenience and to improve customization. GoJS 2.2 also includes new methods for constructing objects, and enhances TypeScript typings support.

GoJS 2.2 also includes several performance enhancements when drawing large graphs, reduced memory usage, and more efficient replacing or merging of item Arrays.

Some of the samples and written documentation have been upgraded to use more modern JavaScript: classes, arrow functions, const and let, so the samples and documentation might no longer be viewable using old browsers such as Internet Explorer 11 or some old Android browsers. The library and the extensions continue to target ES5 (ES2012), so that apps using the library can still work on IE11.

Method Chaining and New Ways to Build Objects

In GoJS 2.2 many methods that previously returned void now return the method's instance, to promote method chaining. GoJS 2.2 also introduces several new methods or arguments to allow type-checking of settings by compilers and in text editors.

Several existing methods now return their instance:

• GraphObject.setProperties and Diagram.setProperties - and their new synonyms GraphObject.attach and Diagram.attach
• Panel.add
• GraphObject.bind, which also has new functionality via method overloads.
• GraphObject.trigger - to add AnimationTriggers to a GraphObject
• Diagram.addEventListener, Diagram.addChangedListener, Diagram.addModelChangedListener, Model.addChangedListener
• Diagram.addLayer, Diagram.addLayerBefore, Diagram.addLayerAfter
• Animation.add, and Animation.addTemporaryPart

GraphObject constructors now accept one or two optional arguments. The first is the value for a common property, and the second is a JavaScript Object detailing properties to initialize. For example, one can now write:

• new go.TextBlock("Some Text", { margin: 5 })
• new go.Picture("sourceURI.png", { width: 30, height: 30 })
• new go.Shape("RoundedRectangle", { fill: "blue", stroke: "yellow" })
• new go.Panel("Auto", { padding: 10, background: "green" })

This means that one can now write code like:

// Create a Node and add a Shape and a TextBlock to it:
myDiagram.nodeTemplate =
  new go.Node("Vertical")
    .add(new go.Shape({ width: 40, height: 40, fill: "white" })  // default width & height & fill
          .bind("width") // binds data.width to Shape.width
          .bind("height")
          .bind("fill", "color") // binds data.color to Shape.fill
          .bind("figure", "fig")) // data.fig should be the registered name of a geometry figure generator
    .add(new go.TextBlock("(no name)",  // default string to display
                          { isMultiline: false, editable: true })
          .bind("text", "name", null, null));  // TwoWay Binding of TextBlock.text with data.name without converters

New methods GraphObject.set and Diagram.set return their instance. When using TypeScript definitions, the compiler checks these calls for GraphObject and Diagram property existence and value types.

New method GraphObject.apply can be used to define common functions that provide settings and bindings. Such customizations can then be applied to a GraphObject that you are initializing by calling GraphObject.apply with that function.

Together, these changes remove the need to use GraphObject.make when concisely defining Diagrams and templates. For a complete example, this code:

const $ = go.GraphObject.make;

const myDiagram = $(go.Diagram, "myDiagramDiv",
  {
    "undoManager.isEnabled": true
  });

myDiagram.nodeTemplate =
  $(go.Node, "Auto",
    $(go.Shape, "RoundedRectangle",
      { strokeWidth: 0, fill: "white" },
      new go.Binding("fill", "color")),
    $(go.TextBlock,
      { margin: 8, font: "bold 14px sans-serif", stroke: '#333' },
      new go.Binding("text", "key"))
  );

Can now be written as:

const myDiagram = new go.Diagram("myDiagramDiv",
  {
    "undoManager.isEnabled": true
  });

myDiagram.nodeTemplate =
  new go.Node("Auto")
    .add(new go.Shape("RoundedRectangle", { strokeWidth: 0, fill: "white" })
          .bind("fill", "color"))
    .add(new go.TextBlock({ margin: 8, font: "bold 14px sans-serif", stroke: '#333' })
          .bind("text", "key"));

For more information and examples, see the intro page on Building Objects.

General New Features in GoJS 2.2

• Spot Panels now support Panel.alignmentFocusName on the main element. This can be useful for creating Spot panels with multiple item arrays that align to the same main element. There is an example of this property in the Spot Panel section of the Panel intro page.
• The Diagram.autoScrollInterval property controls the milliseconds between autoscroll events.
• The Diagram.delayInitialization's argument function is now a passed a reference to the Diagram.
• The Overview.drawsGrid and Overview.updateDelay properties control drawing by an Overview.
• The CommandHandler.isZoomToFitRestoreEnabled property controls whether the CommandHandler.zoomToFit command ever restores the previous Diagram scale and position.
• The DraggingTool.copyCursor, DraggingTool.moveCursor, and DraggingTool.nodropCursor properties modify the cursors during a drag.
• The LinkingBaseTool.linkingCursor property modifies the cursor during linking.
• The GraphObject.findBindingPanel method walks up the visual tree to return the first Panel whose Panel.data is bound to data. Used in the Hyperlink sample.
• The Panel.copyTemplate method makes a deep copy of a Panel, including its Bindings, to allow use of the result in templates. This is used in LinkLabels In Front sample.
• The TextBlock.formatting property controls the policy of trimming whitespace on TextBlock text. This can be useful when text strings are preformatted.
• The TextBlock.lineHeight property provides better information about how the text is being measured and rendered.
• The TextBlock.spacingAbove and TextBlock.spacingBelow properties better control the measuring and rendering in addition to the TextBlock.lineHeight.
• The Node.findExternalTreeLinksConnected method returns a collection of Links that connect with this Node or any in its subtree, excluding any isTreeLink Links. This is the tree-equivalent of Group.findExternalLinksConnected for Groups/subgraphs.
• The Node.findVisibleNode method walks up the chain of Node.containingGroups to find the first node that is visible. This can be overridden to change behavior, as it is in Tree Mapper sample.
• The PanelLayout.remeasureObject method forces a specific GraphObject (but none of its containing panels) to remeasure. This can be useful implementing custom layouts.
• The DraggingTool now optimizes transactions to reduce memory usage by only saving the first and last drag changes. This can be changed by overriding DraggingTool.stopTransaction.
• The Binding constructor now accepts a back-converter as an argument. A null or function argument value as the fourth argument will automatically call Binding.makeTwoWay> for you. Not supplying the fourth argument or passing it undefined will leave the Binding OneWay, as it has in the past.
• The RadialLayout extension by default spreads the children better.
• The TextEditingTool now stops any default animation when the tool is activated.
• The TextEditingTool now respects the vertical alignment when a TextBlock is taller than its text.
• InputEvent.bubbles allows events to bubble beyond the Diagram div. This can be useful in CommandHandler and Tool method overrides.
• For some testing environments: Diagram.isUsingDOM and Diagram.useDOM can query and control the GoJS library's expectation of a DOM existing.
• Fixed a regression from 2.1.29 where some links may update their geometries outside of a transaction.
• Potentially incompatible: Touch and Mouse events have been replaced internally with Pointer events. The GoJS API has not changed, nor has its behavior, as long as the browser is not so old that it does not implement pointer events.

Easier Manipulation and Customization of Geometries

GoJS 2.2 contains new methods to simplify geometric calculations and more easily customize geometries.

• Point.intersectingLineSegments is a static function that returns true if two finite straight line segments intersect each other.
• Rect.intersectsLineSegment is a static function that returns true if a rectangular area is intersected by a finite straight line segment.
• Point.compareWithLineSegment is a static function that compares a point with a finite straight line segment, given x,y numbers. Point.compareWithLineSegmentPoint is a method that performs the same comparison, but on Points.
• Geometry.containsPoint is a method that returns true if the Geometry contains a given point.
• The Link.routeBounds read-only property returns the bounds of the Link geometry in document coordinates. Used in the BalloonLink sample.
• The Node.getAvoidableRect method returns the area to be avoided for this node, equal to the node's GraphObject.actualBounds plus the Node.avoidableMargin. This method can be overridden to customize AvoidsNodes routing behavior near a node to account for the visual area occupied by the node being smaller than the full rectangular bounds of the node.
• Groups now implement Panel.isClipping. If set to true on a Group and if the group has a Group.placeholder, the group will visually clip its member nodes and links. This does not change how those parts are measured, nor does it affect how those parts may be positioned.
• The Layer.isInDocumentBounds property allows finer control of which layers are part of the Diagram.documentBounds. Before 2.2, only layers with Layer.isTemporary set to true were excluded from the document bounds (and could not be explicitly included).
• The ResizingTool.oppositePoint property returns the Point opposite to the chosen, dragged handle of the "Resizing" Adornment. This allows customizations like the LimitedGroupResizingTool sample, which demonstrates a custom tool to allow resizing groups while disallowing the group to resize smaller than its members, and also disallowing the group to expand to cover any non-member nodes.
• The RoundedRectangles extension code now includes definitions for the "RoundedLeftRectangle" and "RoundedRightRectangle" figures. The definitions for all four "Rounded...Rectangle" figures has been modified slightly to better match the curves of a full "RoundedRectangle".

Changes for 2.1.56

• Updated the root object for systems that define window but do not attach all global variables to it. GoJS now prefers globalThis if it exists, then global.

Changes for 2.1.55

• Fixed some improper shadows in the SVG output of Diagram.makeSVG.

Changes for 2.1.54

• Fixed Diagram.viewSize when setting it to a real value and then later setting it back to a NaN value.
• As with 2.1.52, fixed more scenarios with custom animations improperly adding state to the AnimationManager.defaultAnimation.
• Fixed rare cases of LayeredDigraphLayout trying to get the "centerX" property of a null vertex.

• Fixed Binding.ofModel binding when there is no Diagram and thus no Model to just ignore the binding.
• Fixed a regression in Diagram.makeSVG from 2.1.49 when using a Panel.Spot with Panel.isClipping set to true, where some elements would get grouped and positioned incorrectly.
• Fixed Model.toJSON output when object keys contained unescaped double-quote characters.
• Fixed some Shape Geometry intersections (such as with Link connections) when the Shape's Geometry contained small and flat beziers.
• Fixed collapsed Parts incorrectly causing their Groups to remeasure, which may have caused Group's connected Links to re-route.

Changes for 2.1.52

• Fixed animations incorrectly resetting some link routes.
• Fixed custom animations improperly adding state to the AnimationManager.defaultAnimation.
• Fixed a regression in 2.1.51 where un-modeled parts containing Images, that are added before a model is set, may fail to load.
• Fixed a regression from 2.1.50 when Picture.errorFunction was used to modify the Picture.source or Picture.element, which would cause a "Collection was modified during iteration" error.

• Fixed some styling and missing files in the web site as a result of the reorganization in 2.1.39.
• Simplified the Storage and FloorplannerTS projects.

• The TextEditingTool, when the user has entered an invalid text string, has always called any TextBlock.errorFunction and then continued showing the text editor so that the user could fix their text entry. The TextEditingTool.doError method now calls any TextBlock.errorFunction and also calls HTMLInfo.show on the TextEditingTool.currentTextEditor. This will allow an override of TextEditingTool.doError not to continue showing the editor. If you have not overridden that method, which was new in 2.1, this change will not affect you.
• Fixed Model.fromJson not to substitute instances of classes such as Point and Size when the Object's "class" property had a value that is "Point" or "Size". The property value must be what is produced by Model.toJson, which uses values such as "go.Point" or "go.Size". The documentation lists all of the substitution cases that Model.fromJson handles.
• Fixed a regression from 2.1.43 which caused some links to animate routes incorrectly upon dragging.
• Fixed loading Images used as a Picture.element.
• Improved some AvoidsNodes routing of Links when connecting Nodes in different Groups and the Groups are not Group.avoidable.
• Fixed using multiple license keys.

Changes for 2.1.50

• Enhanced the LinkShiftingTool extension to support links that are only connected at one end.
• Fixed CommandHandler.doKeyDown to support Robot.keyDown use of "F2" and "ContextMenu" keys.
• Improved routing of AvoidsNodes links that have a "to" end segment with a direction that is a multiple of 45 (but not 90) degrees.
• Fixed diagram not redrawing after images load in frameworks that use a shadow DOM, such as Angular.
• If you call TextBlock.setBaseline or TextBlock.setUnderline outside of your diagram initialization, you should also call Diagram.redraw on all Diagrams.