@esfaenza/es-table 11.2.69 → 11.2.72

package/lib/components/es-table/es_table.component.d.ts

@@ -16,6 +16,8 @@ import { ThElement } from "../../domain/internals/ThElement";
 import { TdElement } from "../../domain/internals/TdElement";
 import { ItemsSelection } from '../../domain/externals/appsearch/ItemsSelection';
 import { Group } from "../../domain/externals/appsearch/Group";
+import { EsTableModelChange } from '../../domain/externals/EsTableModelChange';
+import { ItemPropEditableReference } from '../../domain/externals/ItemPropEditableReference';
 import { EsTableDefaultable } from '../../domain/configuration/EsTableDefaultable';
 import { EsTdDirective } from '../../directives/es_td.directive';
 import { EsThDirective } from '../../directives/es_th.directive';
@@ -30,7 +32,6 @@ import { SelectionHandler } from "../../core/handlers/SelectionHandler";
 import { UtilitiesHandler } from "../../core/handlers/UtilitiesHandler";
 import { CopyPasteDetector } from '../../core/CopyPasteDetector';
 import { Subject } from 'rxjs';
-declare type InputType = 'string' | 'float' | 'date' | 'number' | 'int' | 'boolean' | 'enum' | 'autocomplete' | 'datetime' | 'time' | 'file' | 'currency';
 /** Componente che permette di rappresentare una griglia di valori */
 export declare class EsTableComponent implements ControlValueAccessor, OnChanges {
     ngControl: NgControl;
@@ -40,9 +41,9 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
     lc: LocalizationService;
     cdr: ChangeDetectorRef;
     private utilities_H;
-    private utiExts;
+    utiExts: UtilityService;
     private expExts;
-    private dateExts;
+    dateExts: DateService;
     private msgExts;
     private copyPasteDetector;
     private clipboardService;
@@ -294,7 +295,9 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
     /** Permette di decidere se, in modalità raggruppamento, mostrare o meno il valore delle colonne di gruppo negli oggetti finali. Di default sono nascosti */
     ShowItemGroupsColumns: any;
     /** Indica che tutti i campi che definiscono le modalità di modifica campo possono essere modificati in base alle impostazioni */
-    UserEdits: boolean;
+    Editable: boolean;
+    /** Indica se è possibile effettuare selezioni a range per poi farci eventualmente copia incolla */
+    RangeSelection: boolean;
     /** Evento che viene richiamato al cambio di oridnamento di una colonna */
     onOrderChanged: EventEmitter<AppOrdering>;
     /**
@@ -313,6 +316,8 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
     onRemoval: EventEmitter<any>;
     /** Evento richiamato all'annullamento di un'eliminazione */
     onAbortRemoval: EventEmitter<any>;
+    /** Evento richiamato alla modifica dei modelli bindati */
+    onModelChange: EventEmitter<EsTableModelChange[]>;
     /** Evento richiamato quando si clicca su un opzione definita nelle **CornerMenuOptions** */
     onCornerAction: EventEmitter<{
         id: string;
@@ -397,15 +402,9 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
     /** Indica lo stato di selezione per singola cella */
     selectionStatus: {
         [index: number]: {
-            [index: number]: {
-                selected: boolean;
-                value: string;
-                type: InputType;
-            };
+            [index: number]: ItemPropEditableReference;
         };
     };
-    /** Ultima cella selezionata singolarmente */
-    private lastSingleSelection;
     /** Opzioni di paginazione */
     PagerOptions: {
         PagerCount: number;
@@ -628,71 +627,8 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
      * @param {number} rowIndex Indice della riga
      */
     dbClickEditOrSingleClickRowSelection($event: any, rowItem: TdElement, item: any, rowIndex: number): void;
-    /**
-     * @TODO Spostare in SelectionHandler
-     *
-     * Registra la selezione singola su una cella sulla combo di comandi "CTRL + Click".
-     * Se viene premuto anche il tasto Shift viene creato un range di selezione il cui status di "selezionato" viene salvato nella
-     * matrice virtuale **selectionStatus**
-     *
-     * @param {any} event Evento Javascript di Click
-     * @param {number} row Indice della riga. Non è l'indice vero e proprio ma è l'ordinale (.ordinal) dell'oggetto bindato su quella riga
-     * @param {number} column Indice della colonna preso banalmente dall'ngIf sui thElement
-     */
-    singleCellSelection(event: any, row: number, column: number): void;
-    /**
-     * @TODO Spostare in SelectionHandler
-     *
-     * Helper per ripulire lo stato di selezione delle singole celle della tabella, ad esclusione di una singola coordinata
-     *
-     * @param {{row: number, column: number}} exclusion Coordinata da escludere nella pulizia
-     */
-    private clearSelectionStatus;
-    /**
-     * @TODO Spostare in SelectionHandler
-     *
-     * Helper che esamina la matrice **selectionStatus** e ne estrappola gli elementi selezionati in una comoda matrice
-     *
-     * @returns {{ value: string, type: InputType }[][]} Matrice di elementi selezionati con la loro informazione sul tipo
-     */
-    private getSelectionStatusSelection;
-    /**
-     * @TODO Spostare in SelectionHandler
-     *
-     * Helper per ripulire la selezione lato HTML
-     *
-     * @param {any} event Evento nativo Javascript
-     */
-    private clearTextSelection;
     /** Evento che gestisce il comando "Copia" buttando i valori selezionati nella clipboard in base al loro tipo */
     private handleCopy;
-    /**
-     * @TODO Spostare in SelectionHandler
-     *
-     * Data la matrice di selezione generata dal metodo **getSelectionStatusSelection** genera la strigna vera e propria da copiare nella Clipboard
-     *
-     * @param {{ value: string, type: InputType }[][]} sel Matrice di selezione con valori e tipi dei dati selezionati
-     *
-     * @returns {string} Stringa da copiare nella clipboard, le stringhe vengono wrappate fra doppi apici e fra un valore e l'altro viene messo un tab
-     * in modo che siano compatibili anche con la copia su Excel
-     */
-    getClipbardTextFromSelection(sel: {
-        value: string;
-        type: InputType;
-    }[][]): string;
-    /**
-     * @TODO Spostare in SelectionHandler
-     *
-     * Ottiene la rappresentazione stringa di un valore dato un tipo
-     *
-     * @param {{ value: string, type: InputType }} valType Oggetto Valore - Tipo da cui estrapolare la rappresentazione del dato in stringa
-     *
-     * @returns {string} Valore convertito in stringa in base al tipo
-     */
-    getValueByType(valType: {
-        value: string;
-        type: InputType;
-    }): string;
     /** Evento che gestisce il comando "Incolla" prendendo i dati della clipboard e applicandoli al range di selezione attuale in base al tipo delle celle sotto */
     handlePaste(): void;
     /** Ripulisce il timer utilizzato per capire se è stato effettuato un doppio click o meno */
@@ -703,23 +639,24 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
      * @param {any} $event Evento nativo javascript
      * @param {any} item Item che rappresenta il contesto su cui è stato effettuato un click
      * @param {boolean} selection Indica se la selezione è attiva
-     *
+     * @param {boolean} internalCall Indica se la chiamata a questa funzione è interna: permette di skippare i check sulle CustomCells
      */
-    handleRowClick($event: any, item: any, selection: boolean): void;
+    handleRowClick($event: any, item: any, selection: boolean, internalCall?: boolean): boolean;
     /**
      * La modifica dell'utente è iniziata. Si imposta la variabile relativa a "true" in modo da mostrare l'input di testo
      *
      * Dopo che l'input è apparso, dopo un ciclo di Change Detection viene attivato il Subject collegato all'input che servirà a effettuare il focus
      *
      * @param {TdElement} rowItem Elemento di riga su cui è stata attivata la modifica
+     * @param {any} item Oggetto sopra il quale è stata attivata la modifica
      */
-    setupUserEdit(rowItem: TdElement): void;
+    setupUserEdit(rowItem: TdElement, item: any): void;
     /**
-     * La modifica dell'utente è terminata. Si reimposta la variabile relativa a "false" in modo da nascondere l'input di testo
+     * La modifica dell'utente è terminata. Si reimposta la variabile relativa a "false" in modo da nascondere l'input di testo e si emette la modifica del valore
      *
      * @param {TdElement} rowItem Elemento di riga su cui è stata attivata la modifica
      * @param {any} item Oggetto sopra il quale è stata attivata la modifica
+     * @param {number} columnIndex Indice della colonna su cui è avvenuta la modifica
      */
-    finalizeUserEdit(rowItem: TdElement, item: any): void;
+    finalizeUserEdit(rowItem: TdElement, item: any, columnIndex: number): void;
 }
-export {};

package/lib/core/handlers/SelectionHandler.d.ts

@@ -1,7 +1,9 @@
 import { ItemsSelection } from "../../domain/externals/appsearch/ItemsSelection";
+import { ItemPropEditableReference } from "../../domain/externals/ItemPropEditableReference";
 import { EsTableComponent } from "../../components/es-table/es_table.component";
 import { EsThDirective } from "../../directives/es_th.directive";
 import { RowGroupingHandler } from "./RowGroupingHandler";
+import { InputType } from '../../domain/types';
 /** Classe che gestisce le selezioni degli oggetti */
 export declare class SelectionHandler {
     private est;
@@ -22,6 +24,8 @@ export declare class SelectionHandler {
     private i_exclusionsCache;
     /** Cache di selezione Hash - Oggetto per la variabile **group_exclusions** dell'itemSelector. Facilita le operazioni di lookup via indice */
     private i_group_exclusionsCache;
+    /** Ultima cella selezionata singolarmente */
+    private lastSingleSelection;
     /** @ignore Costruttore */
     constructor(est: EsTableComponent, rgHandler: RowGroupingHandler);
     /** Ripulisce le cache di selezione */
@@ -154,4 +158,60 @@ export declare class SelectionHandler {
     private evaluateSelected;
     /** Gestisce il comando di "Seleziona tutto in tutte le pagine" o il suo contrario, cioè "Reimposta selezione" */
     selectAllOrResetSelection(): void;
+    /**
+     * @TODO Spostare in SelectionHandler
+     *
+     * Registra la selezione singola su una cella sulla combo di comandi "CTRL + Click".
+     * Se viene premuto anche il tasto Shift viene creato un range di selezione il cui status di "selezionato" viene salvato nella
+     * matrice virtuale **selectionStatus**
+     *
+     * @param {any} event Evento Javascript di Click
+     * @param {number} row Indice della riga. Non è l'indice vero e proprio ma è l'ordinale (.ordinal) dell'oggetto bindato su quella riga
+     * @param {number} column Indice della colonna preso banalmente dall'ngIf sui thElement
+     */
+    singleCellSelection(event: any, row: number, column: number): void;
+    /**
+     * Helper per ripulire lo stato di selezione delle singole celle della tabella, ad esclusione di una singola coordinata
+     *
+     * @param {{row: number, column: number}} exclusion Coordinata da escludere nella pulizia
+     */
+    clearSelectionStatus(exclusion?: {
+        row: number;
+        column: number;
+    }): void;
+    /**
+     * Helper che esamina la matrice **selectionStatus** e ne estrappola gli elementi selezionati in una comoda matrice
+     *
+     * @returns {{ value: string, type: InputType, val_setter: Function }[][]} Matrice di elementi selezionati con la loro informazione sul tipo
+     */
+    getSelectionStatusSelection(): ItemPropEditableReference[][];
+    /**
+     * Helper per ripulire la selezione lato HTML
+     *
+     * @param {any} event Evento nativo Javascript
+     */
+    clearTextSelection(event: any): boolean;
+    /**
+     * Data la matrice di selezione generata dal metodo **getSelectionStatusSelection** genera la strigna vera e propria da copiare nella Clipboard
+     *
+     * @param {{ value: string, type: InputType }[][]} sel Matrice di selezione con valori e tipi dei dati selezionati
+     *
+     * @returns {string} Stringa da copiare nella clipboard, le stringhe vengono wrappate fra doppi apici e fra un valore e l'altro viene messo un tab
+     * in modo che siano compatibili anche con la copia su Excel
+     */
+    getClipbardTextFromSelection(sel: {
+        value: string;
+        type: InputType;
+    }[][]): string;
+    /**
+     * Ottiene la rappresentazione stringa di un valore dato un tipo
+     *
+     * @param {{ value: string, type: InputType }} valType Oggetto Valore - Tipo da cui estrapolare la rappresentazione del dato in stringa
+     *
+     * @returns {string} Valore convertito in stringa in base al tipo
+     */
+    getValueByType(valType: {
+        value: string;
+        type: InputType;
+    }): string;
 }

package/lib/domain/externals/EsTableModelChange.d.ts

@@ -0,0 +1,17 @@
+/** Classe che rappresenta la modifica ad un singolo oggetto in una singola proprietà */
+export declare class EsTableModelChange {
+    item: any;
+    header: string;
+    property: string;
+    old_value: string;
+    new_value: string;
+    /**
+     * Costruttore
+     * @param {any} item Oggetto modificato
+     * @param {string} header Nome dell'Header che è stato modificato
+     * @param {string} property Nome della proprietà modificata
+     * @param {string} old_value Vecchio valore della proprietà **property** dell'oggetto **item**
+     * @param {string} new_value Nuovo valore della proprietà **property** dell'oggetto **item**
+     */
+    constructor(item: any, header: string, property: string, old_value: string, new_value: string);
+}

package/lib/domain/externals/ItemPropEditableReference.d.ts

@@ -0,0 +1,18 @@
+import { InputType } from "../types";
+/** Classe che rappresenta il riferimento ad una proprietà di un oggetto bindato sulla tabella */
+export declare class ItemPropEditableReference {
+    /** Stato di selezione della cella relativa */
+    selected: boolean;
+    /** Oggetto relativo su cui si modificano le proprietà */
+    item: any;
+    /** ID dell'header in modifica (riferimento al TH relativo) */
+    header: string;
+    /** Proprietà Javascript effettivamente in modifica */
+    property: string;
+    /** Tipo dell'input */
+    type: InputType;
+    /** Valore attuale della proprietà **property** dell'oggetto **item** */
+    value: string;
+    /** Funzione che imposta il nuovo valore della proprietà **property** dell'oggetto **item** ed aggiorna il **value** di questo oggetto */
+    val_setter?: (value: string) => any;
+}

package/lib/domain/types.d.ts

@@ -0,0 +1,2 @@
+/** Tipo che rappresenta gli input visualizzabili lato tabella */
+export declare type InputType = 'string' | 'float' | 'date' | 'number' | 'int' | 'boolean' | 'enum' | 'autocomplete' | 'datetime' | 'time' | 'file' | 'currency';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esfaenza/es-table",
-  "version": "11.2.69",
+  "version": "11.2.72",
   "dependencies": {
     "tslib": "^2.0.0"
   },
@@ -8,7 +8,7 @@
     "@angular/common": "~11.2.14",
     "@angular/core": "~11.2.14",
     "@angular/material": "~11.2.13",
-    "@esfaenza/extensions": "^11.2.19",
+    "@esfaenza/extensions": "^11.2.27",
     "@esfaenza/localizations": "^11.2.6",
     "@esfaenza/forms-and-validations": "^11.2.60",
     "@ctrl/ngx-csv": "4.0.0",

package/public-api.d.ts

@@ -20,3 +20,6 @@ export * from './lib/domain/externals/appsearch/EsTableMultiValue';
 export * from './lib/domain/externals/report/ReportColumn';
 export * from './lib/domain/externals/report/ReportParam';
 export * from './lib/domain/externals/report/ReportRow';
+export * from './lib/domain/externals/EsTableModelChange';
+export * from './lib/domain/externals/ItemPropEditableReference';
+export * from './lib/domain/types';