@esfaenza/es-table 11.2.68 → 11.2.71

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

@@ -1,6 +1,6 @@
 import { QueryList, ChangeDetectorRef, EventEmitter, OnChanges, SimpleChanges, ElementRef, TemplateRef } from '@angular/core';
 import { ControlValueAccessor, NgControl } from '@angular/forms';
-import { UtilityService, ExportService, MessageService, DateService, CsvHeaders } from '@esfaenza/extensions';
+import { UtilityService, ExportService, MessageService, DateService, CsvHeaders, ClipboardService } from '@esfaenza/extensions';
 import { LocalizationService } from '@esfaenza/localizations';
 import { PreferencesService } from '@esfaenza/preferences';
 import { ContextMenuComponent } from '@esfaenza/ngx-contextmenu';
@@ -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';
@@ -28,6 +30,7 @@ import { ReportModeHandler } from "../../core/handlers/ReportModeHandler";
 import { RowGroupingHandler } from "../../core/handlers/RowGroupingHandler";
 import { SelectionHandler } from "../../core/handlers/SelectionHandler";
 import { UtilitiesHandler } from "../../core/handlers/UtilitiesHandler";
+import { CopyPasteDetector } from '../../core/CopyPasteDetector';
 import { Subject } from 'rxjs';
 /** Componente che permette di rappresentare una griglia di valori */
 export declare class EsTableComponent implements ControlValueAccessor, OnChanges {
@@ -38,10 +41,12 @@ 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;
     export_H: ExportHandler;
     columnMetadata_H: ColumnMetadataHandler;
     dynamicMode_H: DynamicModeHandler;
@@ -50,8 +55,10 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
     reportMode_H: ReportModeHandler;
     rowGrouping_H: RowGroupingHandler;
     selection_H: SelectionHandler;
+    private copySubscription;
+    private pasteSubscription;
     /** @ignore */
-    constructor(ngControl: NgControl, prefService: PreferencesService, deafults: EsTableDefaultable, locale: string, lc: LocalizationService, cdr: ChangeDetectorRef, utilities_H: UtilitiesHandler, utiExts: UtilityService, expExts: ExportService, dateExts: DateService, msgExts: MessageService);
+    constructor(ngControl: NgControl, prefService: PreferencesService, deafults: EsTableDefaultable, locale: string, lc: LocalizationService, cdr: ChangeDetectorRef, utilities_H: UtilitiesHandler, utiExts: UtilityService, expExts: ExportService, dateExts: DateService, msgExts: MessageService, copyPasteDetector: CopyPasteDetector, clipboardService: ClipboardService);
     /** Subject utilizzato internamente lato EsTable per causare il Focus lato componente di Input */
     FocusSubject: Subject<void>;
     /** Timer che verrà impostato a **doubleClickBufferMs** per capire se è stato effettuato un click singolo o un doubleclick */
@@ -288,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>;
     /**
@@ -307,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;
@@ -388,6 +399,12 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
     ArrayGrouping: boolean;
     /** Indica che l'es-table è basata sulle direttive (nuova modalità) */
     DirectivesBased: boolean;
+    /** Indica lo stato di selezione per singola cella */
+    selectionStatus: {
+        [index: number]: {
+            [index: number]: ItemPropEditableReference;
+        };
+    };
     /** Opzioni di paginazione */
     PagerOptions: {
         PagerCount: number;
@@ -507,6 +524,8 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
      */
     goToPageGroup(page: number, pager: GroupPager): void;
     /**
+     * @TODO Spostare in SelectionHandler
+     *
      * Gestisce i click sulla tabella solo per le righe a gruppo.
      * O rimuove gli elementi attualmente presenti o carica il contenuto del gruppo
      *
@@ -522,6 +541,8 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
      */
     globalCheckChanged(forcedVal?: boolean): void;
     /**
+     * @TODO Spostare in SelectionHandler
+     *
      * Gestisce i click sulla tabella, gestendo eventualmente anche gli Shift + Click per selezionare un range di oggetti
      *
      * @param {any} event Evento nativo HTML del click
@@ -603,11 +624,14 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
      * @param {any} $event Evento nativo javascript
      * @param {TdElement} rowItem Riferimento a binder della riga
      * @param {any} item Item che rappresenta il contesto su cui è stato effettuato un click
-     */
-    dbClickEditOrSingleClickRowSelection($event: any, rowItem: TdElement, item: any): void;
-    /**
-     * Ripulisce il timer utilizzato per capire se è stato effettuato un doppio click o meno
-     */
+     * @param {number} rowIndex Indice della riga
+     */
+    dbClickEditOrSingleClickRowSelection($event: any, rowItem: TdElement, item: any, rowIndex: number): void;
+    /** Evento che gestisce il comando "Copia" buttando i valori selezionati nella clipboard in base al loro tipo */
+    private handleCopy;
+    /** 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 */
     private clearCellClickTimer;
     /**
      * Handler click singolo su una riga
@@ -624,13 +648,15 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
      * 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;
 }

package/lib/core/CopyPasteDetector.d.ts

@@ -0,0 +1,6 @@
+import { Subject } from "rxjs";
+export declare class CopyPasteDetector {
+    OnCopy: Subject<void>;
+    OnPaste: Subject<void>;
+    constructor();
+}

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

@@ -1,6 +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;
@@ -21,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 */
@@ -32,6 +37,13 @@ export declare class SelectionHandler {
      * @param {ItemsSelection<any>} selectionItem Oggetti di selezione derivante dalla view o dall'oggetto per Array
      */
     evaluateSelection(items: any[], selectionItem: ItemsSelection<any>): void;
+    /**
+     * Precompila le informazioni sullo stato di selezione tutto a false per le celle della tabella
+     *
+     * @param {any[]} items Oggetti attualmente bindati sulla tabella
+     * @param {EsThDirective[]} ths Colonne su cui gli oggetti sono bindati
+     */
+    evaluateSingleCellSelection(items: any[], ths: EsThDirective[]): void;
     /**
      * Implementazione agnostica della valutazione delle selezioni degli oggetti. Richiede gli oggetti della vista attuale e l'itemSelector
      *
@@ -146,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/directives/es_th.directive.d.ts

@@ -52,15 +52,15 @@ export declare class EsThDirective {
     thGroup: boolean;
     /** Indica che bisogna fare una aggregazione su questa colonna, a fronte di almeno un altra con un raggruppamento */
     thAggregation: string;
-    /** Impostazioni per la modifica inline di questo campo: la **Property** di riferimento e il **Type** (a scelta fra quelli supportati dal form-adaptive) */
-    thUserEdits: {
-        Property: string;
-        Type: 'string' | 'float' | 'date' | 'number' | 'int' | 'boolean' | 'enum' | 'autocomplete' | 'datetime' | 'time' | 'file' | 'currency';
-        Source: {
-            id: string;
-            description: string;
-        }[];
-    };
+    /** Proprietà JS a cui si riferisce questa cella */
+    thProperty: string;
+    /** Tipo della proprietà JS a cui si riferisce questa cella. Se valorizzato l'utente la potrà modificare facendo doppio click */
+    thType: 'string' | 'float' | 'date' | 'number' | 'int' | 'boolean' | 'enum' | 'autocomplete' | 'datetime' | 'time' | 'file' | 'currency';
+    /** Sorgente dei valori disponibili per questa cella se il **Type** è di tipo 'enum' */
+    thSource: {
+        id: string;
+        description: string;
+    }[];
     /** Indica che questo header deve essere emesso una volta per ogni valore presente nella lista di **EsTableMultiValue** alla proprietà **th** dell'oggetto corrente */
     thMulti: boolean;
     /** Indica un contenuto statico da mostrare piuttosto che utilizzare il **Template**. Serve in caso questo oggetto venga generato programmaticamente */

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/internals/TdElement.d.ts

@@ -36,6 +36,10 @@ export interface TdElement {
     UserEdits?: {
         Property: string;
         Type: string;
+        Source?: {
+            id: string;
+            description: string;
+        }[];
     };
     /** Indica che l'oggetto di bindare per questo td è l'elemento all'indice Y della proprietà Z dove Y e Z vengono prese dall'**ID** scritto come Z_Y */
     Multi?: true;

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.68",
+  "version": "11.2.71",
   "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';