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

package/common/basedatetimecontrol.d.ts

@@ -1,25 +1,78 @@
-import { AfterViewInit, ElementRef, Injector } from '@angular/core';
-import { AbstractControl, ValidationErrors } from '@angular/forms';
-import { Moment } from 'moment';
 import { SacFormLayoutCommon } from '../controls/layout/formlayout';
+import { TooltipPosition } from '../utilities/enums';
 import { SacBaseModelControl } from './basemodelcontrol';
+import { ChangeDetectorRef, DoCheck, ElementRef, Injector, OnDestroy, OnInit } from '@angular/core';
+import { AbstractControl, ValidationErrors } from '@angular/forms';
+import * as moment_ from 'moment';
 /**
  * Base Klasse für Date/Time Controls
  */
-export declare abstract class SacBaseDateTimeControl extends SacBaseModelControl<Date> implements AfterViewInit {
+export declare abstract class SacBaseDateTimeControl extends SacBaseModelControl<Date> implements OnInit, OnDestroy, DoCheck {
     protected elementRef: ElementRef;
+    private readonly cdRef;
+    /**
+     * Helper class to display tooltip on correct position
+     */
+    private readonly popupHelper;
     /**
      * das property enthielt das Value als string. Default ist ''
      */
     protected _valueAsString: string;
+    /**
+     * Containers for the datetime picker
+     */
+    protected pickercontainer: ElementRef<HTMLElement>;
+    /**
+     * Property for enum in Angular HTML template
+     */
+    TooltipPosition: typeof TooltipPosition;
+    /**
+     * Definiert ob der Date Selector angezeigt wird
+     */
+    _showselector: boolean;
     /**
      * Definiert das Control als Required
      */
     isrequired: boolean;
+    /**
+     * Moment JS Instance
+     */
+    moment: any;
+    /**
+     * Arrow Item of Picker Element. Required to set the position of arrow correctly
+     */
+    pickerPosition: typeof TooltipPosition;
+    pickerarrow: ElementRef<HTMLElement> | null;
+    /**
+     * Name of the container for content (e.g. icon) on which the tooltip is displayed.
+     */
+    pickerbutton: ElementRef<HTMLElement>;
     /**
      * TextBox Placeholder
      */
     placeholder: string;
+    /**
+     * Position of the picker arrow at the left
+     */
+    posArrowLeft: number | null;
+    /**
+     * Position of the picker arrow at the top
+     */
+    posArrowTop: number | null;
+    /**
+     * Position of the picker at the left
+     */
+    posPopupLeft: number;
+    /**
+     * Position of the picker at the top
+     */
+    posPopupTop: number;
+    /**
+     * Position of the datetime picker. Values: left|top|right|bottom|auto
+     *
+     * Value 'auto' can be combined with another value.
+     */
+    position: string;
     /**
      * Resource Key für Validation Message DateTimeFormat bei Control
      */
@@ -42,23 +95,50 @@ export declare abstract class SacBaseDateTimeControl extends SacBaseModelControl
      * @param injector Injector for injecting services
      * @param elementRef reference to html element
      */
-    constructor(formlayout: SacFormLayoutCommon, injector: Injector, elementRef: ElementRef);
+    constructor(formlayout: SacFormLayoutCommon, injector: Injector, elementRef: ElementRef, cdRef: ChangeDetectorRef);
     /**
-     * Das Input bekommt das value von typ string
+     * Setter for the name of the container for the tooltip. Is required as the tooltip can be hidden via ngIf.
      */
-    set valuestring(v: string);
+    set picker(picker: ElementRef);
+    get tooltop(): ElementRef;
     /**
      * getter für valuestring
      */
     get valuestring(): string;
+    /**
+     * Das Input bekommt das value von typ string
+     */
+    set valuestring(v: string);
+    /**
+     * Die methode returns dateTime in string
+     */
+    abstract GetDateTimeFormatString(): string;
+    /**
+     * Returns the position of the tooltip
+     */
+    GetPickerPosition(): TooltipPosition;
+    /**
+     * Die methode modifiziert das eingegebene Value von typ Moment
+     */
+    abstract ModifyParsedDateTimeValue(v: moment_.Moment): moment_.Moment;
     /**
      * JSON Date String in ein UTC DateTime Object konvertieren, welches vom Control verwendete werden kann
      */
-    getDate(timestamp: any): any;
+    getDate(timestamp: any): moment.Moment;
+    /**
+     * Calculates the height of the tooltip
+     */
+    getPickerHeight(): number;
+    /**
+     * Calculates the width of the picker
+     */
+    getPickerWidth(): number;
+    ngDoCheck(): void;
+    ngOnDestroy(): void;
     /**
      * Init Event
      */
-    ngAfterViewInit(): void;
+    ngOnInit(): void;
     /**
      * setzt das value von typ string zu property valuestring
      */
@@ -71,13 +151,19 @@ export declare abstract class SacBaseDateTimeControl extends SacBaseModelControl
      * Overwrite WriteValue to Set correct Date Object
      */
     writeValue(value: Date | string): void;
+    protected getArrowHeight(): number;
+    protected getArrowWidth(): number;
     /**
-     * Die methode returns dateTime in string
+     * Calculates the position of the tooltip from links
      */
-    abstract GetDateTimeFormatString(): string;
+    protected getPositionLeft(): number;
     /**
-     * Die methode modifiziert das eingegebene Value von typ Moment
+     * Calculates the position of the tooltip from the top
+     */
+    protected getPositionTop(): number;
+    /**
+     * method if content has changed and proportions need to be reset in the UI.
      */
-    abstract ModifyParsedDateTimeValue(v: Moment): Moment;
-    private SetDateTimeFormat;
+    private readonly onContentChange;
+    private setDateTimeFormat;
 }

package/common/baseinputcontrol.d.ts

@@ -27,10 +27,6 @@ export declare abstract class SacInputBase<VALUE> extends SacBaseModelControl<VA
      * Definiert das Feld als valid/invalid von eingegebenen regex-pattern
      */
     regexvalidation: string;
-    /**
-     * Text welcher als Tooltip angezeigt wird.
-     */
-    tooltiptext: string;
     /**
      * Methode validiert Input wenn KeyPress-Event passiert
      */

package/common/basemodelcontrol.d.ts

@@ -1,21 +1,25 @@
-import { AfterViewInit, Injector, OnInit } from '@angular/core';
-import { AbstractControl, ControlValueAccessor, FormControl, ValidationErrors, Validator } from '@angular/forms';
-import { Observable } from 'rxjs';
 import { SacFormLayoutCommon } from '../controls/layout/formlayout';
 import { ControlHeight } from '../enums/ControlHeight';
 import { ISacConfigurationService } from '../interfaces/ISacConfigurationService';
+import { ISacIconService } from '../interfaces/ISacIconService';
 import { ISacLabelSizes } from '../interfaces/ISacLabelSizes';
 import { ISacLocalisationService } from '../interfaces/ISacLocalisationService';
 import { ISacValidationKeyService } from '../interfaces/ISacValidationKeyService';
+import { Injector, OnInit } from '@angular/core';
+import { AbstractControl, ControlValueAccessor, FormControl, ValidationErrors, Validator } from '@angular/forms';
+import { Observable } from 'rxjs';
 /**
  * Abstract Klasse für SacBaseModelControl. Implements ControlValueAccessor, Validator, OnInit
  */
-export declare abstract class SacBaseModelControl<VALUE> implements ControlValueAccessor, Validator, OnInit, AfterViewInit {
-    private injector;
+export declare abstract class SacBaseModelControl<VALUE> implements ControlValueAccessor, Validator, OnInit {
+    private readonly injector;
     /**
      * Inline Errors für das Control
      */
     private _inlineerrorenabled;
+    /**
+     * Label Text
+     */
     private _label;
     /**
      * Service for loading default settings for the controls
@@ -45,6 +49,10 @@ export declare abstract class SacBaseModelControl<VALUE> implements ControlValue
      * Form layout instance if exists
      */
     protected formlayout: SacFormLayoutCommon;
+    /**
+     * icon service
+     */
+    protected iconService: ISacIconService;
     /**
      * Service für Error Localisation
      */
@@ -53,6 +61,10 @@ export declare abstract class SacBaseModelControl<VALUE> implements ControlValue
      * ngControl
      */
     protected ngControl: FormControl;
+    /**
+     * ControlHeight enum for use in HTML markup
+     */
+    ControlHeight: typeof ControlHeight;
     /**
      * Defines the standard height of the components
      */
@@ -65,6 +77,14 @@ export declare abstract class SacBaseModelControl<VALUE> implements ControlValue
      * Deaktiviert das Label im Template
      */
     disablelabel: boolean;
+    /**
+     * Text to support the user during input.
+     */
+    helptext: string;
+    /**
+     * Mode for display helptext
+     */
+    helptextmode: 'tooltip' | 'text' | null;
     /**
      * defines that error messages are displayed under the controls
      */
@@ -101,10 +121,6 @@ export declare abstract class SacBaseModelControl<VALUE> implements ControlValue
      * Name des Controls
      */
     name: string;
-    /**
-     * ControlHeight enum for use in HTML markup
-     */
-    ControlHeight: typeof ControlHeight;
     /**
      * Leere Implementation von "propagateChange". Muss gemacht werden, damit kein Fehler entsteht
      */
@@ -113,6 +129,10 @@ export declare abstract class SacBaseModelControl<VALUE> implements ControlValue
      * Leere Implementation von "propagateTouch". Muss gemacht werden, damit kein Fehler entsteht
      */
     propagateTouch: any;
+    /**
+     * Detach label text and tooltip from each other in Label so that label and tooltip can be aligned differently. This is in Bootstrap 3 not supported!
+     */
+    splitlabelandhelptext: boolean | null;
     /**
      * Service to receive standard validation message keys and texts
      */
@@ -124,23 +144,21 @@ export declare abstract class SacBaseModelControl<VALUE> implements ControlValue
      */
     constructor(formlayout: SacFormLayoutCommon, injector: Injector);
     /**
-     * Aktiviert oder Deaktiviert die Inline Errors für das Control
+     * Get Icon for Helptext Tooltip
      */
-    set inlineerrorenabled(value: boolean | null);
+    get HelptextTooltipIcon(): string;
     /**
-     * Definiert den Label Text
+     * Methode ergibt Boolean Wert für dirty
      */
-    set label(v: string);
+    get dirty(): boolean;
     /**
-     * Set Methode für NgModel Binding in Html Markup
-     * Input wird benötigt, damit der Wert auch über das Markup gesetzt werden kann.
+     * Show error messages inline
      */
-    set value(v: VALUE);
+    get inlineerrorenabled(): boolean | null;
     /**
-     * Methode ergibt Boolean Wert für dirty
+     * Aktiviert oder Deaktiviert die Inline Errors für das Control
      */
-    get dirty(): boolean;
-    get inlineerrorenabled(): boolean | null;
+    set inlineerrorenabled(value: boolean | null);
     /**
      * Methode ergibt boolean Wert wenn Form invalid oder nicht invalid ist
      */
@@ -157,6 +175,10 @@ export declare abstract class SacBaseModelControl<VALUE> implements ControlValue
      * Definiert den Label Text
      */
     get label(): string;
+    /**
+     * Definiert den Label Text
+     */
+    set label(v: string);
     /**
      * returns an object with all label sizes. These values can then be transferred to corresponding CSS classes using a pipe
      */
@@ -170,13 +192,14 @@ export declare abstract class SacBaseModelControl<VALUE> implements ControlValue
      */
     get value(): VALUE;
     /**
-     * Methode ergibt Error anhand von gegebenen Kriterien
+     * Set Methode für NgModel Binding in Html Markup
+     * Input wird benötigt, damit der Wert auch über das Markup gesetzt werden kann.
      */
-    GetErrorMessage(): Observable<string>;
+    set value(v: VALUE);
     /**
-     * In Angular 10 the Control Label for Reactive Forms can be set first time here. With Angular 13 is supported by init in OnInit
+     * Methode ergibt Error anhand von gegebenen Kriterien
      */
-    ngAfterViewInit(): void;
+    GetErrorMessage(): Observable<string>;
     /**
      * Init Event
      */
@@ -210,14 +233,14 @@ export declare abstract class SacBaseModelControl<VALUE> implements ControlValue
      * Validator Methode
      */
     validate(c: AbstractControl): ValidationErrors | null;
-    /**
-     * Methode zum schreiben von Werten aus dem Model in das Control
-     */
-    writeValue(value: VALUE): void;
     /**
      * Abstrakte Validator Methode
      */
     abstract validateData(c: AbstractControl): ValidationErrors | null;
+    /**
+     * Methode zum schreiben von Werten aus dem Model in das Control
+     */
+    writeValue(value: VALUE): void;
     /**
      * Method can Overwriten in Parent Classes
      * @param value Wert welcher in den korrekten Typ konvertiert werden soll
@@ -241,6 +264,10 @@ export declare abstract class SacBaseModelControl<VALUE> implements ControlValue
      * Set component height from property or parent layout control
      */
     private setComponentHeight;
+    /**
+     * Set mode for helptext. Can be tooltip or text
+     */
+    private setHelpTextMode;
     /**
      * Set adaptive label property from parent layout control
      */
@@ -249,4 +276,5 @@ export declare abstract class SacBaseModelControl<VALUE> implements ControlValue
      * Set label sizes from property or parent layout control
      */
     private setLabelSizes;
+    private setLabelSplitMode;
 }

package/common/baseuploadcontrol.d.ts

@@ -1,21 +1,17 @@
+import { SacFormLayoutCommon } from '../controls/layout/formlayout';
+import { ISacLocalisationService } from '../interfaces/ISacLocalisationService';
+import { ISacUploadEventCompleteState } from '../interfaces/ISacUploadEventCompleteState';
+import { SacBaseModelControl } from './basemodelcontrol';
 import { EventEmitter, Injector, NgZone, OnDestroy, OnInit, Renderer2 } from '@angular/core';
 import { AbstractControl, ValidationErrors } from '@angular/forms';
 import { UploadState, UploadxService } from 'ngx-uploadx';
 import { Observable } from 'rxjs';
-import { SacFormLayoutCommon } from '../controls/layout/formlayout';
-import { ISacIconService } from '../interfaces/ISacIconService';
-import { ISacLocalisationService } from '../interfaces/ISacLocalisationService';
-import { SacBaseModelControl } from './basemodelcontrol';
 /**
  * Base Klasse für Uploader Control
  */
 export declare abstract class SacUploadBase<VALUE> extends SacBaseModelControl<VALUE> implements OnInit, OnDestroy {
     private renderer;
     private ngZone;
-    /**
-     * File Input Control
-     */
-    private uploadInput;
     /**
      * Erlaubte Dateitypen
      */
@@ -32,54 +28,62 @@ export declare abstract class SacUploadBase<VALUE> extends SacBaseModelControl<V
      * API Endpoint
      */
     private _endpoint;
+    /**
+     * Token for Bearer Authentication
+     */
+    private _token;
     /**
      * Upload Settings
      */
     private options;
     /**
-     * icon service to receive icons for uploader
+     * File Input Control
      */
-    protected iconService: ISacIconService;
+    private uploadInput;
     /**
      * Upload Service
      */
     protected uploadService: UploadxService;
+    /**
+     * Handling von neuen Files im Input Control
+     */
+    fileListener: () => void;
     /**
      * Definiert das Control als Required
      */
     isrequired: boolean;
     /**
-     * Max. Dateigrösse für Files die hochgeladen werden können. 0 deaktiviert den Filter
+     * Listener für Files
      */
-    maxfilesize: number;
+    listenerFn: () => void;
     /**
-     * Resource Key für Validation Message Required bei Control
+     * Service für Error Localisation
      */
-    validationmessagerequired: string;
+    lngResourceService: ISacLocalisationService;
     /**
-     * Resource Key für Validation Message Required in Validation Summary
+     * Max. Dateigrösse für Files die hochgeladen werden können. 0 deaktiviert den Filter
      */
-    validationmessagesummaryrequired: string;
+    maxfilesize: number;
     /**
-     * Event wenn ein Error in der Komponente ausgelöst wird.
+     * Event when an error is triggered in the component.
      */
     onfileerror: EventEmitter<string>;
     /**
-     * Handling von neuen Files im Input Control
+     * Event when a file has been uploaded. The event is triggered for multiple uploads per file.
      */
-    fileListener: () => void;
+    onuploadcomplete: EventEmitter<ISacUploadEventCompleteState>;
     /**
-     * Listener für Files
+     * Array von Uploads
      */
-    listenerFn: () => void;
+    uploads: SacUploadFile[];
     /**
-     * Service für Error Localisation
+     * Resource Key für Validation Message Required bei Control
      */
-    lngResourceService: ISacLocalisationService;
+    validationmessagerequired: string;
     /**
-     * Array von Uploads
+     * Resource Key für Validation Message Required in Validation Summary
      */
-    uploads: SacUploadFile[];
+    validationmessagesummaryrequired: string;
     /**
      * Constructor
      * @param formlayout SacFormLayoutCommon to define scoped layout settings
@@ -88,22 +92,6 @@ export declare abstract class SacUploadBase<VALUE> extends SacBaseModelControl<V
      * @param ngZone ngzone for handling external scripts
      */
     constructor(formlayout: SacFormLayoutCommon, injector: Injector, renderer: Renderer2, ngZone: NgZone);
-    /**
-     * Erlaubte Dateitypen für den Upload. Format: ".xxx,.yyy,.zzz"
-     */
-    set allowedtypes(types: string);
-    /**
-     * Files nach der Auswahl automatisch hochladen
-     */
-    set autoupload(v: boolean);
-    /**
-     * Uploads können unterbrochen werden
-     */
-    set enablepause(v: boolean);
-    /**
-     * Definiert den Registration Endpoint für Uploads.
-     */
-    set endpoint(v: string);
     /**
      * Icon for browse button
      */
@@ -125,9 +113,40 @@ export declare abstract class SacUploadBase<VALUE> extends SacBaseModelControl<V
      */
     get IconUpload(): string;
     get allowedtypes(): string;
+    /**
+     * Erlaubte Dateitypen für den Upload. Format: ".xxx,.yyy,.zzz"
+     */
+    set allowedtypes(types: string);
     get autoupload(): boolean;
+    /**
+     * Files nach der Auswahl automatisch hochladen
+     */
+    set autoupload(v: boolean);
     get enablepause(): boolean;
+    /**
+     * Uploads können unterbrochen werden
+     */
+    set enablepause(v: boolean);
     get endpoint(): string;
+    /**
+     * Definiert den Registration Endpoint für Uploads.
+     */
+    set endpoint(v: string);
+    /**
+     * Token for Bearer Authentication
+     */
+    get token(): string | null;
+    /**
+     * Token for Bearer Authentication
+     */
+    set token(v: string | null);
+    /**
+     * Methode kann für Controls verwendet werden, zusätzliche Validierungen bei hinzufügen der Files zu machen
+     *
+     * @param file File das hinzugefügt wurde.
+     * @returns Valdierung ist erfolgreich
+     */
+    abstract CustomAddValidation(file: UploadState): boolean;
     /**
      * Name der Datei die Hochgeladen wird
      * @returns Observable des Dateinamens.
@@ -163,6 +182,12 @@ export declare abstract class SacUploadBase<VALUE> extends SacBaseModelControl<V
      * @returns Upload Fortschritt. Wert von 0-100
      */
     Progress(): number;
+    /**
+     * Methode welche die Upload ID's in das Model setzt oder löscht
+     *
+     * @param file Type von File ID's
+     */
+    abstract SetUploadValue(file: UploadState): void;
     /**
      * Cancel single upload
      * @param uploadId ID of File to cancel
@@ -177,7 +202,7 @@ export declare abstract class SacUploadBase<VALUE> extends SacBaseModelControl<V
      */
     ngOnDestroy(): void;
     /**
-     * Initialisiert das Control
+     * Initializes the control
      */
     ngOnInit(): void;
     /**
@@ -195,6 +220,10 @@ export declare abstract class SacUploadBase<VALUE> extends SacBaseModelControl<V
      * Pause all Uploads
      */
     pauseAll(): void;
+    /**
+     * Sets the bearer token in the upload service
+     */
+    setToken(value: string): void;
     /**
      * Upload Single File
      *
@@ -210,19 +239,6 @@ export declare abstract class SacUploadBase<VALUE> extends SacBaseModelControl<V
      * @param c Control das validiert werden soll
      */
     validateData(c: AbstractControl): ValidationErrors | null;
-    /**
-     * Methode kann für Controls verwendet werden, zusätzliche Validierungen bei hinzufügen der Files zu machen
-     *
-     * @param file File das hinzugefügt wurde.
-     * @returns Valdierung ist erfolgreich
-     */
-    abstract CustomAddValidation(file: UploadState): boolean;
-    /**
-     * Methode welche die Upload ID's in das Model setzt oder löscht
-     *
-     * @param file Type von File ID's
-     */
-    abstract SetUploadValue(file: UploadState): void;
     private UpdateFileCount;
     /**
      * Returns the number of uploaded files

package/controls/checkbox/checkbox.d.ts

@@ -1,13 +1,14 @@
+import { OnInit } from '@angular/core';
 import { AbstractControl, ValidationErrors } from '@angular/forms';
 import { SacBaseModelControl } from '../../common/basemodelcontrol';
 /**
  * Basis Komponente für SacCheckboxCommon. Extends SacBaseModelControl
  */
-export declare class SacCheckboxCommon extends SacBaseModelControl<boolean> {
+export declare class SacCheckboxCommon extends SacBaseModelControl<boolean> implements OnInit {
     /**
-     * Text welcher als Tooltip angezeigt wird.
+     * Defines the display for a checkbox
      */
-    tooltiptext: string;
+    checkboxstyle: 'checkbox' | 'switch' | null;
     /**
      * Text vom Checkbox-Control. Der Text wird rechts von der Checkbox angezeigt.
      */
@@ -16,8 +17,16 @@ export declare class SacCheckboxCommon extends SacBaseModelControl<boolean> {
      * Defines that the checkbox can be used in a list of checkboxes and is not handled as a single form control
      */
     stacked: boolean;
+    /**
+     * Init Event
+     */
+    ngOnInit(): void;
     /**
      * Control hat keinen Validator
      */
     validateData(c: AbstractControl): ValidationErrors | null;
+    /**
+     * Adopts the default display if no display has been defined on the component.
+     */
+    private setCheckboxStyle;
 }