@simpleangularcontrols/sac-common 10.0.0-rc.2 → 10.0.0-rc.21

package/controls/tooltip/tooltip.d.ts

@@ -1,138 +1,145 @@
-import { ChangeDetectorRef, ElementRef, OnDestroy, OnInit } from '@angular/core';
 import { TooltipPosition } from '../../utilities/enums';
+import { AfterViewChecked, ChangeDetectorRef, DoCheck, ElementRef, OnDestroy, OnInit } from '@angular/core';
 /**
  * Tooltip Component
  *
- * Benötigt im HTML Markup folgende Identifier
- * - container: Container für ng-content in welchem das Element angezeigt wird, wo der Tooltip angehängt wird.
- * - tooltip: Container für Tooltip
+ * Requires the following identifiers in the HTML markup
+ * - container: Container for ng-content in which the element is displayed where the tooltip is attached.
+ * - tooltip: Container for tooltip
  *
- * Tooltip muss in 2 Schritten angezeigt werden. In einem ersten Schritt wird der Tooltip Markup erzeugt mit (ngIf). In einem 2. Schritt
- * kann der Tooltip dann über die CSS visibility angezeigt werden. Wird dies nicht so gemacht, kann es bei gewissen Browsern zu einem Flacker Effekt führen.
+ * Tooltip must be displayed in 2 steps. In a first step the tooltip markup is created with (ngIf). In a 2nd step
+ * the tooltip can then be displayed via the CSS visibility. If this is not done, it can lead to a flickering effect in certain browsers.
  *
  */
-export declare class SacTooltipCommon implements OnInit, OnDestroy {
-    private cdRef;
-    private ref;
+export declare abstract class SacTooltipCommon implements OnInit, OnDestroy, AfterViewChecked, DoCheck {
+    private readonly cdRef;
+    private readonly ref;
     /**
-     * Property für Enum in Angular HTML Template
+     * Helper class to display tooltip on correct position
      */
-    TooltipPosition: typeof TooltipPosition;
+    private readonly popupHelper;
     /**
-     * Definiert ob der Tooltip sichtbar ist
+     * Inline mode for tooltip
      */
-    private _isTooltipVisible;
+    private _inlinemode;
     /**
-     * Position des Tooltips oben
+     * Defines whether the tooltip is visible
      */
-    TopPos: number;
+    private _isTooltipVisible;
     /**
-     * Position des Tooltips links
+     * Containers for the tooltip
      */
-    LeftPos: number;
+    private tooltipcontainer;
     /**
-     * Position des Tooltips. Werte: left|top|right|bottom|auto
-     *
-     * Wert 'auto' kann mit einem anderen Wert kombiniert werden.
+     * Position of the tooltip on the left
      */
-    position: string;
+    IsTooltipContentVisible: boolean;
     /**
-     * Text für ToolTip
+     * Position des Tooltips links
      */
-    tooltiptext: string;
+    LeftPos: number;
     /**
-     * Inline Mode für Tooltip
+     * Property for enum in Angular HTML template
      */
-    private _inlinemode;
+    TooltipPosition: typeof TooltipPosition;
     /**
-     * Definiert ob der Tooltip sichtbar sein soll
+     * Position of the tooltip at the top
      */
-    IsTooltipContentVisible: boolean;
+    TopPos: number;
     /**
-     * Setter für Inline Mode für Tooltip
+     * Name of the container for content (e.g. icon) on which the tooltip is displayed.
      */
-    set inlinemode(value: boolean);
+    content: ElementRef<HTMLElement>;
     /**
-     * Getter für Inline Mode für Tooltip
+     * Position of the picker arrow at the left
      */
-    get inlinemode(): boolean;
+    posArrowLeft: number | null;
     /**
-     * Name des Containers für Content (z.B. Icon) auf welchem der Tooltip angezeigt wird.
+     * Position of the picker arrow at the top
      */
-    content: ElementRef<HTMLElement>;
+    posArrowTop: number | null;
     /**
-     * Name des Containers für den Tooltip
+     * Position of the tooltip. Values: left|top|right|bottom|auto
+     *
+     * Value 'auto' can be combined with another value.
      */
-    private tooltipcontainer;
+    position: string;
     /**
-     * Setter für Name des Containers für den Tooltip. Wird benötigt, da Tooltip via NGIF ausgeblendet werden kann.
+     * Text for ToolTip
      */
-    set tooltip(content: ElementRef);
+    tooltiptext: string;
     /**
      * Konstruktor
      * @param ref Element Referenz
      */
     constructor(cdRef: ChangeDetectorRef, ref: ElementRef);
     /**
-     * Ervent wenn das Control initialisert wird
-     */
-    ngOnInit(): void;
-    /**
-     * Event wenn das Control zerstört wird.
+     * Property for inline mode for tooltip. Sets the display mode on the wrapper element to `inline`
      */
-    ngOnDestroy(): void;
+    get inlinemode(): boolean;
     /**
-     * Berechnet die Position des Tooltips von Oben
+     * Setter for inline mode for tooltip
      */
-    private getTopPosition;
+    set inlinemode(value: boolean);
     /**
-     * Berechnet die Position des Tooltips von Links
+     * Setter for the name of the container for the tooltip. Is required as the tooltip can be hidden via ngIf.
      */
-    private getLeftPosition;
+    set tooltip(content: ElementRef);
+    get tooltop(): ElementRef;
     /**
-     * Berechnet die Höhe des Tooltips
+     * Returns the position of the tooltip
      */
-    private getToolTipHeight;
+    GetTooltipPosition(): TooltipPosition;
     /**
-     * Berechnet die Breite die Tooltips
+     * Hide tooltip
      */
-    private getToolTipWidth;
+    HideTooltip(): void;
     /**
-     * Definiert ob der Tooltip im Markup vorhanden ist
+     * Defines whether the tooltip is present in the markup
      */
     IsTooltipVisible(): boolean;
     /**
-     * Tooltip anzeigen
+     * Show tooltip
      */
     ShowTooltip(): void;
     /**
-     * Tooltip ausblenden
+     * Calculates the height of the tooltip
      */
-    HideTooltip(): void;
+    getToolTipHeight(): number;
     /**
-     * Methode wenn Content geändert hat und Proporties im UI neu gesetzt werden müssen.
+     * Calculates the width of the tooltips
      */
-    private onContentChange;
+    getToolTipWidth(): number;
     /**
-     * Gibt die Position des Tooltips zurück
+     * Detect Changes after view checked. Prevent ExpressionChangedAfterItHasBeenCheckedError error
      */
-    GetTooltipPosition(): TooltipPosition;
+    ngAfterViewChecked(): void;
     /**
-     * Definiert ob AutoPosition aktiv ist
+     * Detect UI Changes to Calculate Tooltip correct
      */
-    private IsAutoPosition;
+    ngDoCheck(): void;
     /**
-     * Gibt die definierte Position für den Tooltip zurück
+     * Event when the control is destroyed.
      */
-    private GetPosition;
+    ngOnDestroy(): void;
     /**
-     * Gibt zurück, ob die Position konfiguriert wurde
-     *
-     * @param position Position auf welche geprüft wird
+     * Event when the control is initialized
+     */
+    ngOnInit(): void;
+    /**
+     * Offset for Tooltip. Required for BS4/BS5 to create padding
      */
-    private HasPosition;
+    protected abstract getTooltipOffset(): number;
+    /**
+     * Calculates the position of the tooltip from links
+     */
+    private getLeftPosition;
+    /**
+     * Calculates the position of the tooltip from the top
+     */
+    private getTopPosition;
     /**
-     * Prüft ob die Position gültig ist, resp. der Tooltip auf die Position platz hat
+     * method if content has changed and proportions need to be reset in the UI.
      */
-    private ValidatePositions;
+    private readonly onContentChange;
 }

package/controls/treeview/treeview.d.ts

@@ -1,185 +1,185 @@
-import { EventEmitter, OnInit, TemplateRef } from '@angular/core';
+import { SacBaseModelControl } from '../../common/basemodelcontrol';
+import { TreeviewAction } from '../../interfaces/treeviewaction.interface';
+import { SacFormLayoutCommon } from '../layout/formlayout';
+import { EventEmitter, Injector, TemplateRef } from '@angular/core';
+import { AbstractControl, ValidationErrors } from '@angular/forms';
 /**
  * Basis Komponente für SacTreeView
  */
-export declare class SacTreeViewCommon implements OnInit {
+export declare class SacTreeviewCommon extends SacBaseModelControl<any> {
     /**
-     * Das Property enthielt boolean Wert und deffiniert, ob alle Items collapsed sind. Default value: undefined/null
+     * Event when Action is clicked on Node.  An object of the type 'TreeviewAction' is returned. In the default case, 'action' in this object is always the value 'default'. The value can be changed via the 'templateaction'.
      */
-    _collapseAll: boolean;
+    actionclicked: EventEmitter<TreeviewAction>;
     /**
-     * Das Property enthielt boolean Wert und deffiniert, ob alle Items selected sind. Default value: undefined/null
+     * Property on the data object that contains the children of the structure element. Must be an array of objects. The default value is 'children'
      */
-    private _selectAll;
+    attrchildren: string;
     /**
-     * Das Property enthielt array of nodes. Default value: empty array [].
+     * Defines the property on the 'data' object with which the actions for a node can be deactivated. A 'disabled' property is used by default.
      */
-    nodes: any[];
+    attrdisableaction: string;
     /**
-     * Das Property enthielt node attribute: 'isCollapsed'. Es wird benutzt beim rendering. Für Expand/Collapsed Sicht des Node(Wert)
+     * Property on the 'data' object that stores the expanded state. Property must be of type boolean. Default is 'expanded'
      */
-    collapseAttr: string;
+    attrexanded: string;
     /**
-     * Das Property enthielt node attribute: 'isSelected'. Es wird benutzt beim Vorbereitung des Data des TreeView
+     * Property for saving the HoverState on the field. If the property is not present on the node, it is automatically created and removed again. The value can usually be left at the default value unless there is a conflict with a property on the node that is required for other purposes.
      */
-    selectAttr: string;
+    attrhoverstate: string;
     /**
-     * Das Property enthielt node attribute: 'isIndeterminate'. Es wird benutzt beim Vorbereitung des Data des TreeView
+     * Property on 'data' object, which contains the icon for the node. By default, the property is not set, which hides the icon in the node.
      */
-    inDeterminateAttr: string;
+    attricon: string | null;
     /**
-     * Providen data for tree.
+     * property on the 'data' object contains an ID of the node. The default is 'id'. If the property is set to NULL, the selectedId event is no longer triggered.
      */
-    private _data;
+    attrid: string | null;
     /**
-     * Getter für Data des TreeView
+     * Property on 'data' object, which contains the label for the node. Default is 'label'
      */
-    get data(): any[];
+    attrlabel: string;
     /**
-     * Input Property für Data des TreeView
+     * Property on 'data' object, which defines whether the node is selected or not. It should be ensured that only 1 node has the value for Selected set to true. Default is 'selected'.
      */
-    set data(value: any[]);
+    attrselected: string;
     /**
-     * Input Property für template des TreeView. Type: TemplateRef<any>.
+     * Event when a node is collapsed. Returns the node element as a parameter
      */
-    template: TemplateRef<any>;
+    collabsed: EventEmitter<any>;
     /**
-     * Die Directive erhält die actions für das TreeView
+     * The property contains an array of nodes. The data must already map the tree via child properties.
      */
-    set treeviewTemplate(v: TemplateRef<any>);
+    data: any[];
     /**
-     * Getter für das TreeView Template
+     * Activates the 'expand' and 'collabse' event even if a node has no children. This is helpful if node elements are to be reloaded at runtime.
      */
-    get treeviewTemplate(): TemplateRef<any>;
+    enableasynchload: boolean | string;
     /**
-     * Input property erhält Icon für das Template
+     * Activates Ellipsis on the node labels
      */
-    fileicontemplate: TemplateRef<any>;
+    enableellipsis: boolean;
     /**
-     * Setter property. Deffiniert das FileIcon für das TreeView
+     * Event when a node is expanded. Returns the node element as a parameter
      */
-    set treefileicon(v: TemplateRef<any>);
+    expanded: EventEmitter<any>;
     /**
-     * Getter property. Ergibt das FileIcon für das TreeView
+     * Defines whether an icon for the expanded/collapsed status should be displayed.
      */
-    get treefileicon(): TemplateRef<any>;
+    expandedstate: boolean | string;
     /**
-     * Input property für den Namen des TreeView. Type string. Default value: ""
+     * A node must be selected
      */
-    name: string;
-    /**
-     * A flag indicating data is flatten in array and prepare is required.(Default
-     * is false).
-     */
-    prepareData: boolean;
-    /**
-     * Attribute for Text in Tree
-     */
-    textAttr: string;
-    /**
-     * Name of ID property in input data.
-     */
-    idAttr: string;
+    isrequired: boolean;
     /**
-     * Name of parent property in input data.
+     * Name of the TreeView control
      */
-    parentAttr: string;
-    /**
-     * Name of children list property in input data.
-     */
-    childrenAttr: string;
-    /**
-     * Title des Treeview
-     */
-    title: any;
-    /**
-     * Collapse or expand all parent nodes.
-     */
-    set collapseall(value: boolean);
+    name: string;
     /**
-     * Getter für das collapse property. Ergibt boolean Wert, ob die Items collapsed/expand sind.
+     * Event when a node is selected. Returns the id attribute as a parameter. The event is not triggered if 'attrid' is not set.
      */
-    get collapseall(): boolean;
+    selected: EventEmitter<any>;
     /**
-     * Select or deselect all nodes.
+     * Event when a node is selected. Returns the node element as a parameter.
      */
-    set selectall(value: boolean);
+    selectednode: EventEmitter<any>;
     /**
-     * Input property - setter. Deffiniert das ID des selektierten Item(node)
+     * Defines that the action template is displayed independently of the selected state. If the value is 'true', the action template is displayed for every element.
      */
-    set selectedid(v: any);
+    showactionalways: any;
     /**
-     * Getter. Ergibt das ID des selektierten Item(node)
+     * Custom template for actions per node. Template parameters are: 'node'
      */
-    get selectedId(): any;
+    templateaction: TemplateRef<any>;
     /**
-     * Das Property erhält das selektierte Wert(node). Default value: undefined/null
+     * Custom template for icon per node. Template parameters are: 'node'
      */
-    private _selectedNode;
+    templateicon: TemplateRef<any>;
     /**
-     * Setter für das selektierte Wert(node). Wenn aufgerufen das ID und TextAttr des selected Node wird emitted
+     * Custom template for the label area per node. Template parameters are: 'node' and 'label'
      */
-    set selectedNode(v: any);
+    templatelabel: TemplateRef<any>;
     /**
-     * Getter für das selektierte Wert(node). Ergibt das selektierte Wert(node).
+     * Resource Key für Validation Message Required bei Control
      */
-    get selectedNode(): any;
+    validationmessagerequired: string;
     /**
-     * Output Emitter. Emit das ID des selected Node.
+     * Resource Key für Validation Message Required in Validation Summary
      */
-    selectedidchange: EventEmitter<any>;
+    validationmessagesummaryrequired: string;
     /**
-     * Output Emitter. Emit das TextAttr des selected Node.
+     * Constructor
+     * @param injector Service Injector
      */
-    selectedtextchanged: EventEmitter<string>;
+    constructor(formlayout: SacFormLayoutCommon, injector: Injector);
+    get iconAction(): string;
     /**
-     * Output Emitter. Emit wenn ein Node selektiert wird.
+     * CSS icon for folders in tree there are collabsed
+     * @returns css class with icon
      */
-    selecteditem: EventEmitter<string>;
+    get iconFolderCollabsed(): string;
     /**
-     * A lifecycle hook that is called after Angular has initialized all data-bound properties of a directive.
-     * Define an ngOnInit() method to handle any additional initialization tasks.
+     * CSS icon class for folders without subfolders
+     * @returns css class with icon
      */
-    ngOnInit(): void;
+    get iconFolderEmpty(): string;
     /**
-     * Funktion setzt alle parent items recusiv zum selected node
-     * auf collapsed = false
+     * CSS icon for folders in tree there are expanded
+     * @returns css class with icon
      */
-    private openSelectedNode;
+    get iconFolderOpen(): string;
     /**
-     * Die Methode vorbereitet die Daten für das TreeView. Die Funktion sollte geändert werden abhängig von dem kommenden Daten (wenn array)
+     * Creates an array of a certain size. Is required for a For in the UI, as Angular does not support counting loops
+     * @param size Size of the array
+     * @returns Array
      */
-    private LoadTree;
+    count(size: number): Array<void>;
+    getChildren(node: any): any[];
+    getStringField(node: any, fieldname: string): any;
+    hasChildren(node: any): boolean;
+    isDisabledState(node: any): boolean;
+    isExpandedState(node: any): boolean;
+    isHoverState(node: any): boolean;
+    isSelectedState(node: any): boolean;
     /**
-     * Die Methode collapse/expand den selectierten Node
+     * Method is called by clicking an action
+     * @param action action and node
      */
-    onCollapseClick(node: any): void;
+    onActionClicked(action: TreeviewAction): void;
     /**
-     * Die Methode set den selektierten Node und emit es.
+     * Method is called when Node in Tree is clicked
+     * @param node Selected Node
      */
-    onClick(node: any): void;
+    onNodeClicked(node: any): void;
     /**
-     * Die Methode wird ein event mit Meldung zu Parent emit-en.
+     * Sets the hover state on a node
+     * @param node Node on which the status is set
+     * @param state Activate or deactivate HoverState
      */
-    sendMsgToParent(msg: any): void;
+    setHoverState(node: any, state: boolean): void;
     /**
-     * Die Methode wird alle Nodes collapse
+     * Sets the selected state on a node
+     * @param node Node which is marked as Selected
      */
-    collapseAllNode(command: any): void;
+    setSelectedState(node: any): void;
     /**
-     * Funktion gibt node aus der liste zurück, welches das Value auf dem gewünschten Attribut hat
-     * Wenn node nicht gefunden wird, wird null zurück gegeben
-     * @param data Liste der nodes
-     * @param searchValue Das gesuchte value
-     * @param attr Der namen des Attributs auf dem das value gesucht wird
+     * Validates the model state of the control
+     * @param c Control instance
+     * @returns Returns a validation error, if present. Otherwise, as Result is NULL
      */
-    private findNode;
+    validateData(c: AbstractControl): ValidationErrors | null;
     /**
-     * Die Methode editiert (recursive) alle eingegebene Nodes abhängig von gegebenen Attibute und Value Kriterien.
+     * Saves the data from the model binding
+     * @param value Id of the selected node
      */
-    private _recursiveEdit;
+    writeValue(value: any): void;
     /**
-     * Die Methode erstellt eine standarte Sicht-Liste von Nodes
+     * Searches for a node based on the value in the ID attribute
+     * @param node Node
+     * @param value Value of the Id attribute
+     * @returns Returns the node if it is found. If not, NULL is returned.
      */
-    private _getPreparedData;
+    private findNodeById;
+    private invertExpandedState;
+    private resetSelectedState;
 }