@esfaenza/es-table 11.2.66 → 11.2.69

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';
@@ -28,7 +28,9 @@ 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';
+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;
@@ -42,6 +44,8 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
     private expExts;
     private dateExts;
     private msgExts;
+    private copyPasteDetector;
+    private clipboardService;
     export_H: ExportHandler;
     columnMetadata_H: ColumnMetadataHandler;
     dynamicMode_H: DynamicModeHandler;
@@ -50,8 +54,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 */
@@ -388,6 +394,18 @@ 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]: {
+                selected: boolean;
+                value: string;
+                type: InputType;
+            };
+        };
+    };
+    /** Ultima cella selezionata singolarmente */
+    private lastSingleSelection;
     /** Opzioni di paginazione */
     PagerOptions: {
         PagerCount: number;
@@ -507,6 +525,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 +542,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 +625,77 @@ 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
+     * @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
      */
-    dbClickEditOrSingleClickRowSelection($event: any, rowItem: TdElement, item: any): void;
+    singleCellSelection(event: any, row: number, column: number): void;
     /**
-     * Ripulisce il timer utilizzato per capire se è stato effettuato un doppio click o meno
+     * @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 */
     private clearCellClickTimer;
     /**
      * Handler click singolo su una riga
@@ -634,3 +722,4 @@ export declare class EsTableComponent implements ControlValueAccessor, OnChanges
      */
     finalizeUserEdit(rowItem: TdElement, item: any): void;
 }
+export {};

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,5 +1,6 @@
 import { ItemsSelection } from "../../domain/externals/appsearch/ItemsSelection";
 import { EsTableComponent } from "../../components/es-table/es_table.component";
+import { EsThDirective } from "../../directives/es_th.directive";
 import { RowGroupingHandler } from "./RowGroupingHandler";
 /** Classe che gestisce le selezioni degli oggetti */
 export declare class SelectionHandler {
@@ -32,6 +33,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
      *

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/appsearch/AppSearch.d.ts

@@ -75,7 +75,8 @@ export declare class AppSearch<T> {
      */
     requestedgroups: GroupFilter[];
     /**
-     * Permette di resettare questo oggetto ai valori di default
+     * Permette di resettare un AppSearch ai valori di default.
+     * Reso statico perché fra una deserializzazione e l'altra si potrebbe perdere il prototype del costruttore
      */
-    reset(): void;
+    static reset(aps: AppSearch<any>): void;
 }

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esfaenza/es-table",
-  "version": "11.2.66",
+  "version": "11.2.69",
   "dependencies": {
     "tslib": "^2.0.0"
   },