3.1.0

GoJS 3.1

GoJS 3.1 brings a number of new features, including the ability to manipulate any diagram using only the keyboard, and support for screen readers.

New Features and Changes for GoJS 3.1

Keyboard Controlled Focus Navigation and Virtual Pointer

The CommandHandler now supports keyboard-controlled focus navigation and a virtual pointer, so that the user need not use a mouse. Enable it in any Diagram with the Ctrl-Alt-Enter command.

This new functionality includes built-in minimal support for screen readers. However, each application will need to customize what is read in each situation. The AriaCommandHandler extension is now deprecated.

Read a summary at Focus and Keyboard Control. Read more details at Accessibility.

Using CSS variables for theming

The ThemeManager can now read CSS variables such that your GoJS templates can reuse variables from other parts of your UI. This functionality is controlled by the new ThemeManager.readsCssVariables property, which defaults to true. Read more at Using CSS variables for theming.

Link routing improvements

Link routing is improved for links connecting member Nodes with their containing Groups, and for ...Side Spot links that do not cross adjacent links.

Link routing for AvoidsNodes has also been improved when links are fully within Groups.

Licensing improvements

3.1 comes with a new licensing mechanism for unlimited domains. If you have trouble upgrading, please contact support.

The LassoSelectingTool extension

The LassoSelectingTool is an optional replacement for the standard DragSelectingTool that allows the user to freehand draw a line around the Parts that they want to select. Try it in the Lasso Selecting sample.

Other New Features

• "Toggle" switches are a new kind of predefined button which is commonly requested for the more complex node templates. See the Toggle switches sample.
• The "AutoRepeatButton" has been moved from the "ScrollingTable" extension to be a built-in builder, as another type of predefined button. This makes it easier for you to use auto-repeating buttons in your diagrams.
• The GuidedDraggingTool extension has been improved to support centering a Part to have equal space on both sides. Try the tool in the Guided Dragging sample.
• The CommandHandler.zoomToFit command now takes an optional argument so that you can easily perform an animated zoom to a particular Rect in document coordinates.
• The new CommandHandler.storageLocation property may be set to "localStorage" or "sessionStorage" in order to save the clipboard state in a Storage object. For compatibility the value defaults to "memory". This subsumes the implementation in the LocalStorageCommandHandler extension, which remains for compatibility in versions of GoJS older than 3.1, but is now deprecated.
• The new CommandHandler.downloadSvg command makes it easy for your app to download an image of your diagram as SVG. For example, see the Genogram sample.
• The DrawCommandHandler extension has been extended with the DrawCommandHandler.saveLocalFile and DrawCommandHandler.loadLocalFile methods. This supports downloading a JSON-formatted text file produced by Model.toJson, and loading such a file via either a DrawCommandHandler.localFileInput <input> element or a DrawCommandHandler.localFileDropElement drop-handling element. Try it in the Local Files sample.
• SvgRendererOptions now has the "svgFinished" option to allow modifying the whole <svg> element after it has been rendered by Diagram.makeSvg. This is useful if you need to modify the SVG each time it is produced.
• TextBlock.letterSpacing and TextBlock.wordSpacing are new properties that affect the measurement and rendering of text. Caution: these properties are not supported on all platforms.
• New Node methods Node.findSuccessorParts and Node.findPredecessorParts walk the graph starting at a Node, collecting all of the Links and Nodes it sees, but not including the original Node itself. Basically Node.findSuccessorParts returns a Set of all Nodes and Links that are "downstream" from this Node or are "descendants" of this Node. Node.findPredecessorParts does the same, but walking backwards "upstream" or to "ancestors" of the Node.
• Link.corner is now supported for non-orthogonal link segments, so link path turns can look softer without using Bezier Link.curve. For example, see the Double Tree sample, to which we added the setting corner: 10.
• The LayeredDigraphLayout.centered and LayeredDigraphVertex.centered properties control whether the nodes in each layer are aligned to the center (the default) or to the closer side (typically top or left side) of the layer.
• The Router.isRoutable method is an overridable predicate to help decide if a particular Link needs to be routed.
• One can now pass arguments to be passed to GraphObject.apply functions, to parameterize a call to an initialization function applied to GraphObjects. For examples, search the samples for calls to GraphObject.apply that have two (or more) arguments. Note how those applied functions also take two (or more) arguments.
• The Rect.nearestSideDirection and Rect.nearestSideDirectionPoint decide which side of a Rect is closest to the given point.
• The Geometry constructor now takes an optional second argument that is used as an initialization object.
• The "ToolTip" Adornment now detects GraphObject.mouseOver events and automatically extends how long the tooltip will stay visible by ToolManager.toolTipDuration milliseconds.
• If the ToolManager.currentToolTip is visible, the Escape key will hide it. Hit Escape again to clear the Diagram.selection and stop any ongoing tool.
• The ContextMenuTool now handles mouse wheel events in the standard fashion when that tool is running, including zooming the diagram scale.
• The ResizingTool can now resize the labels of Links, and the RotatingTool can now rotate the labels of Links, although they continue not to be able to resize or rotate whole Links or their Link paths.
• Animation performance has improved when starting and stopping multiple animations.
• An example Playwright test file is now in the Introduction page about Testing.
• We have added a Venn Diagram sample.
• Minor API incompatibility: ThemeBinding.themeSource no longer accepts null as a value -- use the ...

3.0.27

Changes for 3.0.27

• SVG Rendering context: Fixed TextBlock rendering when TextBlock.maxLines was set and the lines were affected by clipping.

3.0.26

Changes for 3.0.26

• SVG Rendering context: Fixed re-adding removed elements from the DOM, for example if GraphObject.visible is toggled.

3.0.25

Changes for 3.0.25

• Fixed Diagram.transformDocToView when called by a "ViewportBoundsChanged" DiagramEvent listener when the Diagram.scale has changed.
• Fix for undocumented GraphObject.filter setter in the SVG rendering context.

3.0.23

Changes for 3.0.23

• Removed static { . . . } initialization blocks, an ES2022 feature, from the library.
• Setting the Diagram.renderer to "svg" no longer throws an error in non-DOM environments.
• Remove instanceof checks for the browser interface Path2D, in case some systems have their own implementation.

3.0.22

Changes for 3.0.22

• Fixed the potential creation of DOM elements on library load, which may interfere with some non-DOM environments or setting Diagram.useDom.

3.0.21

Changes for 3.0.21

• Simplified some minified names for simpler debugging.
• Licensing fixes on some systems.

3.0.20

Changes for 3.0.20

Fixed Diagram.allowDragOut causing a Diagram's Diagram.documentBounds to fluctuate while dragging Parts out of the Diagram.

Fixed an unusual initialization exception involving Links with AvoidsNodes routing and collapsed Groups.

3.0.19

Changes for 3.0.19

• Fixed Diagram.zoomToFit or CommandHandler.zoomToFit failing to account for any Diagram.scrollMargin.
• Fixed the undoing/redoing of removing a label node key from a link data's label keys Array.
• Fixed the Overview.box not updating on large observed Diagram scrolls.

2.3.18

Changes for 2.3.18

• Fixed SVG rendering context when updating TextBlock.stroke
• Fixed Table Panel layout when some previously-visible elements were set to invisible.
• Fix for SVG Diagram.renderer shadows: building some objects would cause a shadow to disappear when redrawn.
• Fixed Table Panel regression from 2.3.13: Some elements that both spanned and stretched would measure a column or row too large