Updated api reference

Author: BasicPrimitives

apireference/orgdiagram.md

@@ -92,6 +92,8 @@ Organizational Chart configuration object. Use this object as a reference for av
  | `normalLevelShift` | number | `20` | Sets the spacing between rows. | 
  | `orientationType` | OrientationType | `0` | Set diagram orientation. This option controls diagram layout orientation. The control can be rotated in any direction, this is needed for Arabic support and various layouts. | 
  | `pageFitMode` | PageFitMode | `3` | Page fit mode. Minimizing nodes into markers and labels. This option provides a special mode that renders the diagram nodes in the form of markers. This is a highly scalable form that is capable of rendering large numbers of nodes while not affecting the rendering performance. With this, huge diagrams can be fit into avaialable screen space. When using a graphics editor to manually draw your diagrams, it is common place to have large gaps between the nodes. This can make the diagram/chart unreadable, hard to edit and navigate. On top of that, on a large scale the diagram could have screen size intervals between items. Admittedly the computer UI does allow the user to scale and fit the diagram in order to visualize it on a single screen. But in that case, the items become small and unreadable as there is no scaling priority and the items are just too small to be readable. | 
+ | `placeAdvisersAboveChildren` | boolean | `true` | Sets default placement of advisers hierarchies relative to the regular children of the parent node. If adviser node has its own children then control adds extra levels, so advisers children are placed above level of the parent node children. | 
+ | `placeAssistantsAboveChildren` | boolean | `true` | Sets default placement of assistants hierarchies relative to the regular children of the parent node. If assitant node has its own children then control adds extra levels, so assistants children are placed above level of the parent node children. | 
  | `scale` | number | `1` | CSS3 scale transform. Control supports content scaling using CSS scale transform. It scales everything except scroll bars. It properly handles mouse event coordinates. The CSS scale transform produces unreadable text and corrupted lines in desktop browsers, it looks good only in mobile browsers, so our recomendation is to use zoom with collection of item templates of various sizes. Templates gives you better control over quality of your content at various zoom levels. | 
  | `selectCheckBoxLabel` | string | `"Selected"` | Selection check box label. See `hasSelectorCheckbox` and `selectedItems` properties. | 
  | `selectedItems` | string[] | `[]` | Selected items collection. Selected items is a collection of items ids having checked their check boxes. The control always shows selected items in the full size form, regardless of enabled page fit mode. The control notifies about user made changes in this collection with `onSelectionChanging` and `onSelectionChanged` events. | 
@@ -144,8 +146,11 @@ Item Configuration Object defines properties of individual node in the organizat
  | `labelOrientation` | TextOrientationType | `3` | Label orientation. If `Auto` then it is set to `labelOrientation` property of the control configuration. | 
  | `labelPlacement` | PlacementType | `0` | Label placement. Sets label placement relative to the marker bounding rectangle. If `Auto` then it is set to `labelPlacement` of the control configuration. | 
  | `labelSize` | Size | `null` | Label size. Sets label's placeholder `div` size and controls conflict resolution if labels overlap each other. If `null` then it is set to `labelSize` property of the control configuration. | 
+ | `levelOffset` | number | `null` | Sets node level offset relative to parent node. This property is ignored if it is not applicable. | 
  | `minimizedItemShapeType` | ShapeType | `null` | Marker type. The shape of the marker when node is minimized by autofit. The control supports auto fit of diagram into available screen space. When diagram size significantly larger than available screen space, its scrolling and navigation becomes problematic, so control supports automatic diagram fit into the screen space via rendering some of its nodes in form of small markers. So this option sets marker shape for individual node. | 
  | `parent` | string | `null` | Parent item id. If `null` then node is the root item of the hierarchy. | 
+ | `placeAdvisersAboveChildren` | Enabled | `0` | Sets default placement of advisers hierarchies relative to the regular children of the node. If adviser node has its own children then control adds extra levels, so advisers children are placed above level of the regular children. | 
+ | `placeAssistantsAboveChildren` | Enabled | `0` | Sets default placement of assistants hierarchies relative to the regular children of the node. If assitant node has its own children then control adds extra levels, so assistants children are placed above level of the regular children. | 
  | `showCallout` | Enabled | `0` | Sets callout annotation visibility for individual node. The callout annotation is one of easy to use features of the control. By default it is displayed for markers in order to preview their node's content. The content is displayed using current template of the node it is rendered for. The callout can be forced to be displayed for regular nodes as well. In that case use `calloutTemplateName` property to change their template. Auto - depends on `showCallout` property of the control True - shown regardless of node's visibility False - hidden | 
  | `showLabel` | Enabled | `0` | Sets label visibility for individual nodes. Labels are only rendered for a node's markers. The control does not preserve space for labels in the diagram layout, since that would contradict the purpose of minimizing the nodes into markers. Use controls `dotLevelShift`, `dotItemsInterval` properties to preserve space between nodes for labels. Labels are displayed inside of `div`s of the fixed size, see `labelSize` property, and control provides simple conflict resoltion to avoid labels overlapping. If two labels overlap each other with their bounding rectangles then only one of them is going to stay visible. Auto - displays label only when it has space to be rendered. True - shows label regardless, even if it overlaps other labels and nodes. False - hidden. | 
  | `templateName` | string | `null` | Template name. Templates are HTML fragments containing layout and styles used to render diagram nodes. They are defined with a named configuration objects. See `templates` property of control's configuration object. This option lets individually assign rendering template per individual node of the diagram. | 

src.primitives/Controls/OrgDiagram/Tasks/Transformations/VisualTreeTask.js

@@ -44,6 +44,7 @@ primitives.orgdiagram.VisualTreeTask = function (orgTreeTask, activeItemsTask, v
       leftSiblingIndex,
       rightSiblingIndex,
       index, len,
+      item,
       childIndex,
       childrenLen,
       depth,
@@ -181,7 +182,7 @@ primitives.orgdiagram.VisualTreeTask = function (orgTreeTask, activeItemsTask, v
               visualTree.add(shiftParent.id, treeItem.id, treeItem);
               treeItem = shiftParent;//ignore jslint
             case primitives.orgdiagram.ItemType.Assistant://ignore jslint
-              var parent = createNewVisualAggregatorWithGivenDepth(visualTree, logicalParentItem, false, false, orgItem.levelOffset || 0)
+              var parent = createNewVisualAggregatorWithGivenDepth(visualTree, logicalParentItem, false, false, orgItem.levelOffset || 0);
               switch (orgItem.adviserPlacementType) {
                 case primitives.common.AdviserPlacementType.Left:
                   visualTree.add(parent.id, treeItem.id, treeItem, 0);
@@ -284,12 +285,12 @@ primitives.orgdiagram.VisualTreeTask = function (orgTreeTask, activeItemsTask, v
 
       var aggregators = [];
       if (regularChildrenLevels.length > 0) {
-        var visualParent = getLastVisualAggregator(visualTree, logicalParentItem);
+        visualParent = getLastVisualAggregator(visualTree, logicalParentItem);
         for (var indexLevel = 0; indexLevel < regularChildrenLevels.length - 1; indexLevel += 1) {
           var regularChildrenLevel = regularChildrenLevels[indexLevel];
           if (regularChildrenLevel != null) {
             var hideChildConnector = (logicalParentItem.visibility == primitives.common.Visibility.Invisible) && (logicalParentItem.connectorPlacement === 0);
-            nextVisualParent = createNewVisualAggregator(visualTree, visualParent, hideChildConnector);
+            var nextVisualParent = createNewVisualAggregator(visualTree, visualParent, hideChildConnector);
 
             aggregators.push([nextVisualParent]);
 
@@ -308,14 +309,14 @@ primitives.orgdiagram.VisualTreeTask = function (orgTreeTask, activeItemsTask, v
             }
 
             for (index = medianIndex; index >= 0; index -= 1) {
-              var item = regularChildrenLevel[index];
+              item = regularChildrenLevel[index];
               visualTree.add(visualParent.id, item.id, item, 0);
               item.connectorPlacement = primitives.common.SideFlag.Top | primitives.common.SideFlag.Bottom;
               item.gravity = primitives.common.HorizontalAlignmentType.Right;
             }
 
             for (index = medianIndex + 1; index < regularChildrenLevel.length; index += 1) {
-              var item = regularChildrenLevel[index];
+              item = regularChildrenLevel[index];
               visualTree.add(visualParent.id, item.id, item);
               item.connectorPlacement = primitives.common.SideFlag.Top | primitives.common.SideFlag.Bottom;
               item.gravity = primitives.common.HorizontalAlignmentType.Left;
@@ -356,7 +357,7 @@ primitives.orgdiagram.VisualTreeTask = function (orgTreeTask, activeItemsTask, v
               }
               break;
             case primitives.common.Enabled.True:
-              extendChildren = true
+              extendChildren = true;
               break;
           }
 
@@ -384,7 +385,7 @@ primitives.orgdiagram.VisualTreeTask = function (orgTreeTask, activeItemsTask, v
               }
               break;
             case primitives.common.Enabled.True:
-              extendChildren = true
+              extendChildren = true;
               break;
           }
           if (extendChildren) {
@@ -845,8 +846,8 @@ primitives.orgdiagram.VisualTreeTask = function (orgTreeTask, activeItemsTask, v
 
   function createNewVisualAggregatorWithGivenDepth(visualTree, treeItem, hideParentConnector, hideChildrenConnector, depth) {
     var result = null,
-      newAggregatorItem,
-      hideParentConnector = hideParentConnector || hideChildrenConnector;
+        newAggregatorItem;
+    hideParentConnector = hideParentConnector || hideChildrenConnector;
 
     var index = 0;
     while (index <= depth) {