Version 3 of the JavaScript Diagram library contains the following new features and improvements:
User-interaction controllersAll kinds of user interaction are now carried out by controller objects. The startDraw method of BehaviorBase-derived classes that returned an opaque InteractionState instance has been replaced by createController method returning a controller of class specific to the modified item and interaction types. Built-in controllers include CreateNodeController, CreateLinkController, ModifyNodeController, ModifyLinkController, LaneGridController. You can also create custom controllers by deriving and overriding the methods of SinglePointerController -
SinglePointerController.prototype =
{
start: function (position) {},
move: function (position) {},
validate: function (position) {},
commit: function (position) {},
cancel: function (position) {},
drawInteraction: function (context) {}
}
Record and replayThe Diagram class provides record, stopRecording and replay methods that can be used to save and replay all user actions with keyboard and mouse. The replay method takes (recording, timer, diagramJson) parameters. The recording argument is an array of records returned by stopRecording. If the timer argument is set to true, events are replayed from a timer preserving their original timing, otherwise they are replayed immediately. Timer mode can be used to show tutorials played directly in the diagram. Immediate mode could be used to automate user interaction testing where an assertion is checked after replaying series of events. Recorded events could also be replayed as macros if ran on a diagram with items placed on same initial coordinates.
Improved testabilityUser interaction can now be tested automatically in several ways outlined below.
~ create a MouseInputDispatcher instance and call its methods -
onMouseDown: function (position, button)
onMouseMove: function (position)
onMouseUp: function (position, button)
where position in MindFusion.Drawing.Point instance specifying logical coordinates in the diagram (in current measure unit, not scaled by zoom factor). The results of called mouse methods will depend on diagram's current Behavior, e.g. you could assert that a sequence of down/move/up events creates a ShapeNode when Behavior is set to DrawShapes.
~ create an instance of controller class and call its start, move and commit methods. This would not depend on the value of Diagram.Behavior, but could be still affected by other behavioral properties such as AllowSelfLoops and AllowUnconnectedLinks.
~ Check assertions after replaying a recording on a saved diagram.
Ruler controlThe Ruler control provides horizontal and vertical scales that help users measure and align diagram items. In order to set up a Ruler instance, create a DIV element parenting the diagram's scroller div -
<div id="ruler">
<div id="view">
<canvas id="diagram" width="2100" height="2100">
...
var ruler = MindFusion.Diagramming.Ruler.create(document.getElementById("ruler"));
ruler.setDiagram(diagram);
3rd party dependencies now optionalThe diagram can now be used without JQuery and Microsoft Ajax libraries. To enable that mode, set MindFusionImpl = "StandAloneImpl" before loading diagramming.js. Stand-alone mode requires relatively modern browsers, the base feature-set against we test it is the one of IE11.
Flip shapesThe shape of a ShapeNode can be flipped horizontally or vertically. Enable the AllowFlip property and the shape flips when an edge is dragged over its opposite edge. You can get or set current flip state using FlipX and FlipY properties.
Revamped item dependency systemDependencies between diagram items are now expressed by rule objects and applied in sequence by the DiagramMediator class. Built-in dependencies are implemented by ItemFollowsContainerRule, AttachedFollowsMasterRule, LinkFollowsNodesRule, NodeFollowsSelectionRule rules. You can create custom rule objects with following API and add them to DiagramMediator.AllRules array to make items follow other items during user interaction -
var MyRule =
{
dependencies: function (master) {}, // return array of items that should follow master
dependentUpon: function (dependency) {}, // return array of items that should be followed by dependency
recognize: function (dependency) {}, // return true or false if this rule shoudl be applied on an item
updateFromMasters: function (dependency, originalStates) // set new position or size of dependency
}
License keysThere is no separate trial build of the control's scripts anymore. Instead it verifies a license key string specified either by calling Diagram.setLicenseKey(key_string) method or by adding a diagram_lic.txt file to the application's directory on web server.
Miscellaneous~ CaptionBackBrush and FoldIconSize properties added to ContainerNode.
~ Multiple rotation of nodes improved, now node angles are modified by same rotation delta calculated from mouse position instead of pointing all rotation handles in mouse direction.
~ Xml serialization improved.
~ Diagram.LinkSegments property specifies initial number of link segments.
~ JQuery mode now supports version 3 of JQuery.
If anyone is interested in trying the beta version, please download this archive containing updated script files and sample projects:
https://mindfusion.eu/_beta/jsdiagram3.zipAny comments, questions and general feedback are welcome.