data-table-list 1.0.3 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,572 +1,648 @@
1
- # Guida all'Utilizzo e all'Implementazione di `DataTableList`
2
-
3
- `DataTableList` è un componente riutilizzabile sviluppato in **Vue 3** (con TypeScript e Composition API). Offre una tabella dati flessibile con supporto nativo per paginazione, ordinamento, filtraggio, azioni di riga, esportazione dati, e selezione multipla tramite checkbox.
4
-
5
- ---
6
-
7
-
8
- [![downloads](https://img.shields.io/github/stars/badges/shields)](https://github.com/mssalvo/data-table-list-vue3) [npm version](https://npmjs.com)
9
-
10
- ---
11
-
12
- ## Project Setup
13
-
14
- ```sh
15
- npm install data-table-list@latest
16
- ```
17
-
18
- ---
19
-
20
- ## usage
21
-
22
-
23
- ```ts
24
- import { DataTableList, Avatar } from 'data-table-list';
25
- import type { DataTableConf } from 'data-table-list';
26
- import 'data-table-list/dist/data-table-list.css'; // This imports the new stable CSS
27
-
28
- ```
29
-
30
-
31
- ---
32
-
33
- ## 1. Strutture Dati e Interfacce (Modelli)
34
-
35
- Il componente utilizza le seguenti interfacce TypeScript definite in [Models.ts](file:///c:/Users/UTENTE/Desktop/progettoIA/data-table-list/src/model/Models.ts):
36
-
37
- ```ts
38
- export interface DataTableConf {
39
- columns: ColumnTable[]; // Configurazione delle colonne
40
- actionsRow?: ActionRow; // Azioni di default abilitate per riga
41
- viewActions: boolean; // Se mostrare o meno la colonna delle azioni
42
- viewDownload?: boolean; // Se visualizzare il pulsante per il download/esportazione
43
- paginator?: boolean; // Abilita la paginazione
44
- paginatorPosition?: PaginatorPosition; // Posizione e allineamento del paginatore
45
- isserver?: boolean; // Se la paginazione e il filtraggio sono gestiti lato server
46
- serverPaging?: ServerPaging; // Metadati per la paginazione server-side
47
- dimensionePagina: number; // Numero di righe per pagina
48
- messageNotRecords?: string; // Messaggio mostrato se la tabella è vuota
49
- }
50
-
51
- export interface ColumnTable {
52
- title: string; // Intestazione della colonna
53
- property: string; // Nome della chiave nell'oggetto riga
54
- style?: string | null; // Stile CSS inline da applicare alla cella (es: "width: 150px")
55
- callFormatt?: Function | null; // Funzione custom per formattare il valore della cella
56
- hidden?: boolean; // Nasconde la colonna se impostato a true
57
- order?: boolean; // Abilita l'ordinamento client-side per questa colonna
58
- }
59
-
60
- export interface ActionRow {
61
- view: boolean; // Mostra l'icona Visualizza (it-password-visible)
62
- update: boolean; // Mostra l'icona Modifica (it-pencil)
63
- delete: boolean; // Mostra l'icona Elimina (it-delete)
64
- }
65
-
66
- export interface PaginatorPosition {
67
- top: boolean; // Mostra il paginatore sopra la tabella
68
- bottom: boolean; // Mostra il paginatore sotto la tabella
69
- class: string | 'center' | 'left' | 'right'; // Allineamento del paginatore ('left', 'center', 'right')
70
- }
71
-
72
- export interface ServerPaging {
73
- serverTotaleElementi: number; // Numero totale di elementi sul server
74
- serverTotalePagine: number; // Numero totale di pagine sul server
75
- }
76
- ```
77
-
78
- ---
79
-
80
- ## 2. API del Componente (Props ed Emits)
81
-
82
- ### Props (Proprietà)
83
-
84
- | Nome Prop | Tipo | Obbligatorio | Descrizione |
85
- | :--- | :--- | :--- | :--- |
86
- | `dataTableConf` | `DataTableConf` | **Sì** | Configurazione della struttura e del comportamento della tabella. |
87
- | `dataItems` | `any[]` | **Sì** | Array di dati (righe) da visualizzare. Se `isserver` è `false`, contiene tutti i record. Se `isserver` è `true`, contiene solo i record della pagina corrente. |
88
- | `filter` | `string` | No | Stringa di ricerca globale. Se specificata e `isserver` è `false`, la tabella esegue un filtro client-side su tutte le colonne visibili. |
89
- | `showCheckbox` | `boolean` | No | Se impostato a `true`, aggiunge una prima colonna con checkbox per la selezione multipla delle righe. |
90
-
91
- ### Emits (Eventi)
92
-
93
- | Nome Evento | Parametri | Descrizione |
94
- | :--- | :--- | :--- |
95
- | `@onview` | `(obj: object)` | Emesso al click sul pulsante "Visualizza" della riga (default action). Riceve l'oggetto riga. |
96
- | `@onupdate` | `(obj: object)` | Emesso al click sul pulsante "Modifica" della riga (default action). Riceve l'oggetto riga. |
97
- | `@ondelete` | `(obj: object)` | Emesso al click sul pulsante "Elimina" della riga (default action). Riceve l'oggetto riga. |
98
- | `@onavanti` | `(current: number, size: number)` | Emesso quando si va alla pagina successiva **solo se** `isserver` è `true`. `current` è l'indice di pagina (0-indexed), `size` è la dimensione della pagina. |
99
- | `@onindietro` | `(current: number, size: number)` | Emesso quando si va alla pagina precedente **solo se** `isserver` è `true`. `current` è l'indice di pagina (0-indexed), `size` è la dimensione della pagina. |
100
- | `@ondownload` | `(call: any[])` | Emesso al click sul pulsante di download. Riceve la lista corrente dei dati filtrati. |
101
- | `@onchecked` | `(obj: any[])` | Emesso ogni volta che cambia la selezione delle righe tramite checkbox. Riceve l'array delle righe attualmente selezionate. |
102
-
103
- ---
104
-
105
- ## 3. Slot di Personalizzazione
106
-
107
- `DataTableList` offre diversi slot con scoped-slots per personalizzare profondamente il markup:
108
-
109
- * **`#columnTd`**: Permette di personalizzare il rendering del contenuto di ogni cella. Riceve `{ row, column }` come parametri dello slot.
110
- * **`#iconTd`**: Consente di posizionare un'icona o un elemento decorativo a fianco del valore della cella. Riceve `{ row, column }`.
111
- * **`#actions`**: Sostituisce i pulsanti di default (Visualizza, Modifica, Elimina) con pulsanti personalizzati o menu dropdown. Riceve `{ row }`.
112
- * **`#checkbox`**: Sostituisce il checkbox di default delle righe. Riceve `{ row }`.
113
- * **`#download`**: Personalizza l'aspetto del pulsante di download. Riceve l'evento `{ ondownload: { oncall: Function } }`.
114
-
115
- ---
116
-
117
- ## 4. Scenari d'Uso ed Esempi di Implementazione
118
-
119
- ### Scenario A: Tabella Semplice Client-Side con Paginazione e Ordinamento
120
- In questo scenario, i dati sono interamente caricati in memoria. Il componente gestisce la paginazione, la ricerca globale e l'ordinamento in modo autonomo.
121
-
122
- ```html
123
- <script setup lang="ts">
124
- import { ref } from 'vue';
125
- import { DataTableList, Avatar } from 'data-table-list';
126
- import type { DataTableConf } from 'data-table-list';
127
- import 'data-table-list/dist/data-table-list.css';
128
-
129
- const searchFilter = ref('');
130
-
131
- const tableConfig = ref<DataTableConf>({
132
- columns: [
133
- { title: 'ID', property: 'id', order: true },
134
- { title: 'Nome', property: 'name', order: true },
135
- { title: 'Email', property: 'email', order: true }
136
- ],
137
- isserver: false,
138
- paginator: true,
139
- paginatorPosition: { top: true, bottom: true, class: 'right' },
140
- viewActions: true,
141
- actionsRow: { view: true, update: true, delete: true },
142
- dimensionePagina: 5,
143
- messageNotRecords: 'Nessun utente trovato.'
144
- });
145
-
146
- const items = ref([
147
- { id: 1, name: 'Mario Rossi', email: 'mario.rossi@example.com' },
148
- { id: 2, name: 'Giuseppe Verdi', email: 'giuseppe.verdi@example.com' },
149
- { id: 3, name: 'Luca Bianchi', email: 'luca.bianchi@example.com' },
150
- { id: 4, name: 'Anna Neri', email: 'anna.neri@example.com' },
151
- { id: 5, name: 'Sofia Gialli', email: 'sofia.gialli@example.com' },
152
- { id: 6, name: 'Elena Rosa', email: 'elena.rosa@example.com' }
153
- ]);
154
-
155
- const handleView = (item: any) => console.log('Visualizza:', item);
156
- const handleUpdate = (item: any) => console.log('Modifica:', item);
157
- const handleDelete = (item: any) => console.log('Elimina:', item);
158
- </script>
159
-
160
- <template>
161
- <div class="container my-4">
162
- <!-- Input di ricerca collegato alla prop :filter -->
163
- <div class="form-group mb-3">
164
- <label for="search">Cerca Utente</label>
165
- <input id="search" v-model="searchFilter" type="text" class="form-control" placeholder="Cerca...">
166
- </div>
167
-
168
- <DataTableList
169
- :data-items="items"
170
- :data-table-conf="tableConfig"
171
- :filter="searchFilter"
172
- @onview="handleView"
173
- @onupdate="handleUpdate"
174
- @ondelete="handleDelete"
175
- />
176
- </div>
177
- </template>
178
- ```
179
-
180
- ---
181
-
182
- ### Scenario B: Formattazione Personalizzata di Colonne (`callFormatt`)
183
- Quando si desidera applicare una formattazione al volo su una colonna (es. date, valute, o composizione stringhe) senza alterare i dati di origine, si può definire la funzione `callFormatt` nel modello `ColumnTable`.
184
-
185
- ```ts
186
- const tableConfig = ref<DataTableConf>({
187
- columns: [
188
- { title: 'ID', property: 'id' },
189
- {
190
- title: 'Nome Completo',
191
- property: 'name',
192
- // callFormatt riceve il valore del campo specificato in property e l'intera riga
193
- callFormatt: (value: any, row: any) => {
194
- return `${row.name.toUpperCase()} (${row.role})`;
195
- }
196
- },
197
- {
198
- title: 'Data Creazione',
199
- property: 'createdAt',
200
- callFormatt: (value: string) => {
201
- return new Date(value).toLocaleDateString('it-IT');
202
- }
203
- }
204
- ],
205
- isserver: false,
206
- viewActions: false,
207
- dimensionePagina: 10
208
- });
209
-
210
- const items = ref([
211
- { id: 1, name: 'Mario Rossi', role: 'Admin', createdAt: '2026-06-01T10:00:00Z' },
212
- { id: 2, name: 'Giuseppe Verdi', role: 'User', createdAt: '2026-06-03T15:30:00Z' }
213
- ]);
214
- ```
215
-
216
- ---
217
-
218
- ### Scenario C: Personalizzazione Celle con Slot (`#columnTd` & Componenti Custom)
219
- Se si necessita di inserire markup HTML complesso (es. Badge di stato, icone, o componenti esterni come `Avatar.vue`), si utilizza lo slot `#columnTd`.
220
-
221
- ```html
222
- <script setup lang="ts">
223
- import { ref } from 'vue';
224
- import { DataTableList, Avatar } from 'data-table-list';
225
- import type { DataTableConf } from 'data-table-list';
226
- import 'data-table-list/dist/data-table-list.css';
227
-
228
- const tableConfig = ref<DataTableConf>({
229
- columns: [
230
- { title: 'Avatar', property: 'avatar', style: 'width: 80px;' },
231
- { title: 'Dettagli Utente', property: 'details' },
232
- { title: 'Stato', property: 'status' }
233
- ],
234
- isserver: false,
235
- viewActions: false,
236
- dimensionePagina: 5
237
- });
238
-
239
- const items = ref([
240
- { id: 1, name: 'Mario Rossi', email: 'mario.rossi@example.com', status: 'Attivo', statusColor: 'bg-success' },
241
- { id: 2, name: 'Giuseppe Verdi', email: 'giuseppe.verdi@example.com', status: 'Sospeso', statusColor: 'bg-warning' }
242
- ]);
243
- </script>
244
-
245
- <template>
246
- <DataTableList :data-items="items" :data-table-conf="tableConfig">
247
- <!-- Utilizzo dello scoped slot per le celle -->
248
- <template #columnTd="{ row, column }">
249
-
250
- <!-- Cella Avatar -->
251
- <div v-if="column.property === 'avatar'">
252
- <Avatar
253
- :label="row.name.charAt(0) + row.name.split(' ')[1]?.charAt(0)"
254
- :background-dynamics="true"
255
- />
256
- </div>
257
-
258
- <!-- Cella Dettagli Utente -->
259
- <div v-else-if="column.property === 'details'">
260
- <strong>{{ row.name }}</strong><br>
261
- <small class="text-secondary">{{ row.email }}</small>
262
- </div>
263
-
264
- <!-- Cella Stato -->
265
- <div v-else-if="column.property === 'status'">
266
- <span class="badge rounded-pill text-white" :class="row.statusColor">
267
- {{ row.status }}
268
- </span>
269
- </div>
270
-
271
- </template>
272
- </DataTableList>
273
- </template>
274
- ```
275
-
276
- ---
277
-
278
- ### Scenario D: Selezione Multipla con Checkbox e Evento `@onchecked`
279
- Il componente supporta la selezione di elementi tramite una colonna di checkbox abilitata tramite la prop `:show-checkbox="true"`.
280
-
281
- ```html
282
- <script setup lang="ts">
283
- import { ref } from 'vue';
284
- import { DataTableList, Avatar } from 'data-table-list';
285
- import type { DataTableConf } from 'data-table-list';
286
- import 'data-table-list/dist/data-table-list.css';
287
-
288
- const tableConfig = ref<DataTableConf>({
289
- columns: [
290
- { title: 'ID', property: 'id' },
291
- { title: 'Prodotto', property: 'product' }
292
- ],
293
- isserver: false,
294
- viewActions: false,
295
- dimensionePagina: 10
296
- });
297
-
298
- const items = ref([
299
- { id: 101, product: 'Computer Laptop' },
300
- { id: 102, product: 'Monitor 4K' },
301
- { id: 103, product: 'Tastiera Meccanica' }
302
- ]);
303
-
304
- const selectedItems = ref<any[]>([]);
305
-
306
- // Salva gli elementi selezionati nello stato locale
307
- const handleChecked = (checkedRows: any[]) => {
308
- selectedItems.value = checkedRows;
309
- console.log('Prodotti selezionati:', selectedItems.value);
310
- };
311
- </script>
312
-
313
- <template>
314
- <div class="my-3">
315
- <DataTableList
316
- :data-items="items"
317
- :data-table-conf="tableConfig"
318
- :show-checkbox="true"
319
- @onchecked="handleChecked"
320
- />
321
-
322
- <div class="mt-3">
323
- <h5>Elementi selezionati: {{ selectedItems.length }}</h5>
324
- <ul>
325
- <li v-for="item in selectedItems" :key="item.id">{{ item.product }}</li>
326
- </ul>
327
- </div>
328
- </div>
329
- </template>
330
- ```
331
-
332
- ---
333
-
334
- ### Scenario E: Menu Azioni Personalizzato (Dropdown Bootstrap Italia)
335
- Invece di mostrare i tre pulsanti standard in linea (view, update, delete), è possibile personalizzare la colonna delle azioni inserendo un menu a comparsa (dropdown) in perfetto stile Bootstrap Italia utilizzando lo slot `#actions`.
336
-
337
- ```html
338
- <script setup lang="ts">
339
- import { ref } from 'vue';
340
- import { DataTableList, Avatar } from 'data-table-list';
341
- import type { DataTableConf } from 'data-table-list';
342
- import 'data-table-list/dist/data-table-list.css';
343
-
344
- const tableConfig = ref<DataTableConf>({
345
- columns: [
346
- { title: 'ID', property: 'id' },
347
- { title: 'Documento', property: 'docName' }
348
- ],
349
- isserver: false,
350
- viewActions: true, // Deve essere true per abilitare la colonna azioni
351
- dimensionePagina: 10
352
- });
353
-
354
- const items = ref([
355
- { id: 1, docName: 'Fattura_2026_01.pdf' },
356
- { id: 2, docName: 'Contratto_Firmato.pdf' }
357
- ]);
358
-
359
- const scaricaDocumento = (row: any) => console.log('Download', row.docName);
360
- const archiviaDocumento = (row: any) => console.log('Archivia', row.id);
361
- </script>
362
-
363
- <template>
364
- <DataTableList :data-items="items" :data-table-conf="tableConfig">
365
- <!-- Personalizzazione colonna azioni tramite slot -->
366
- <template #actions="{ row }">
367
- <div class="dropdown dropstart text-center">
368
- <a class="btn btn-dropdown dropdown-toggle" href="#" role="button" id="dropdownActions" data-bs-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
369
- <!-- Icona a tre pallini di Bootstrap Italia -->
370
- <svg class="icon-expand icon icon-sm icon-secondary">
371
- <use href="@/assets/svg/sprites.svg#it-more-items"></use>
372
- </svg>
373
- </a>
374
- <div class="dropdown-menu" aria-labelledby="dropdownActions">
375
- <div class="link-list-wrapper">
376
- <ul class="link-list">
377
- <li>
378
- <a class="dropdown-item list-item" @click.prevent="scaricaDocumento(row)">
379
- <span>
380
- <svg class="icon icon-primary" aria-hidden="true">
381
- <use href="@/assets/svg/sprites.svg#it-download"></use>
382
- </svg> Scarica
383
- </span>
384
- </a>
385
- </li>
386
- <li>
387
- <a class="dropdown-item list-item" @click.prevent="archiviaDocumento(row)">
388
- <span>
389
- <svg class="icon icon-primary" aria-hidden="true">
390
- <use href="@/assets/svg/sprites.svg#it-box"></use>
391
- </svg> Archivia
392
- </span>
393
- </a>
394
- </li>
395
- </ul>
396
- </div>
397
- </div>
398
- </div>
399
- </template>
400
- </DataTableList>
401
- </template>
402
- ```
403
-
404
- ---
405
-
406
- ### Scenario F: Paginazione Server-Side (`isserver: true`)
407
- Se la sorgente dati ha molti elementi, la paginazione deve avvenire sul server.
408
- * `isserver` deve essere impostato a `true`.
409
- * È necessario compilare `serverPaging` con i totali di elementi e pagine forniti dalle API.
410
- * Bisogna ascoltare gli eventi `@onavanti` e `@onindietro` per richiedere la pagina corretta al server e aggiornare l'array `dataItems`.
411
-
412
- ```html
413
- <script setup lang="ts">
414
- import { ref, onMounted } from 'vue';
415
- import { DataTableList, Avatar } from 'data-table-list';
416
- import type { DataTableConf } from 'data-table-list';
417
- import 'data-table-list/dist/data-table-list.css';
418
-
419
- // Stato locale per i dati e il caricamento
420
- const items = ref<any[]>([]);
421
- const loading = ref(false);
422
-
423
- const tableConfig = ref<DataTableConf>({
424
- columns: [
425
- { title: 'ID', property: 'id' },
426
- { title: 'Descrizione', property: 'description' }
427
- ],
428
- isserver: true, // Indica che paginazione e ricerca avvengono sul server
429
- paginator: true,
430
- paginatorPosition: { top: false, bottom: true, class: 'center' },
431
- viewActions: false,
432
- dimensionePagina: 10,
433
- serverPaging: {
434
- serverTotaleElementi: 0, // Inizializzato a 0, popolato in seguito
435
- serverTotalePagine: 0
436
- }
437
- });
438
-
439
- // Funzione simulata per caricare i dati dalle API
440
- const fetchApiData = async (page: number, size: number) => {
441
- loading.value = true;
442
- try {
443
- // Es. const res = await axios.get(`/api/items?page=${page}&size=${size}`);
444
- await new Promise((resolve) => setTimeout(resolve, 400));
445
-
446
- const mockTotalElements = 50;
447
- const mockTotalPages = Math.ceil(mockTotalElements / size);
448
-
449
- // Creazione dati simulati per la pagina corrente (es. pagina 0 -> ID 1-10)
450
- const rows = [];
451
- const start = page * size;
452
- for (let i = 0; i < size; i++) {
453
- const id = start + i + 1;
454
- if (id <= mockTotalElements) {
455
- rows.push({ id, description: `Elemento server ${id}` });
456
- }
457
- }
458
-
459
- items.value = rows;
460
-
461
- // Aggiornamento dei metadati di paginazione server-side
462
- tableConfig.value.serverPaging = {
463
- serverTotaleElementi: mockTotalElements,
464
- serverTotalePagine: mockTotalPages
465
- };
466
- } finally {
467
- loading.value = false;
468
- }
469
- };
470
-
471
- // Gestione del cambio pagina in avanti
472
- const handleAvanti = async (currentPage: number, size: number) => {
473
- await fetchApiData(currentPage, size);
474
- };
475
-
476
- // Gestione del cambio pagina all'indietro
477
- const handleIndietro = async (currentPage: number, size: number) => {
478
- await fetchApiData(currentPage, size);
479
- };
480
-
481
- onMounted(async () => {
482
- // Caricamento iniziale
483
- await fetchApiData(0, tableConfig.value.dimensionePagina);
484
- });
485
- </script>
486
-
487
- <template>
488
- <div class="container my-4">
489
- <h3>Paginazione Server-Side</h3>
490
- <div v-if="loading" class="alert alert-info">Caricamento...</div>
491
-
492
- <DataTableList
493
- :data-items="items"
494
- :data-table-conf="tableConfig"
495
- @onavanti="handleAvanti"
496
- @onindietro="handleIndietro"
497
- />
498
- </div>
499
- </template>
500
- ```
501
-
502
- ---
503
-
504
- ### Scenario G: Esportazione e Download dei Dati Filtrati
505
- Il componente offre la possibilità di abilitare un pulsante per il download dei dati.
506
- * Impostare `viewDownload: true` nella configurazione `DataTableConf`.
507
- * Ascoltare l'evento `@ondownload`, che riceve la lista dei record attualmente filtrati dalla ricerca globale (`filterComputer`).
508
-
509
- ```html
510
- <script setup lang="ts">
511
- import { ref } from 'vue';
512
- import { DataTableList, Avatar } from 'data-table-list';
513
- import type { DataTableConf } from 'data-table-list';
514
- import 'data-table-list/dist/data-table-list.css';
515
-
516
- const searchFilter = ref('');
517
-
518
- const tableConfig = ref<DataTableConf>({
519
- columns: [
520
- { title: 'ID', property: 'id' },
521
- { title: 'Nome', property: 'name' }
522
- ],
523
- isserver: false,
524
- viewActions: false,
525
- viewDownload: true, // Mostra l'icona per il download in alto a destra
526
- dimensionePagina: 10
527
- });
528
-
529
- const items = ref([
530
- { id: 1, name: 'Mario Rossi' },
531
- { id: 2, name: 'Giuseppe Verdi' },
532
- { id: 3, name: 'Luca Bianchi' }
533
- ]);
534
-
535
- // Funzione di esportazione CSV client-side al click sul download
536
- const handleDownload = (filteredData: any[]) => {
537
- const csvHeaders = 'ID,Nome\n';
538
- const csvRows = filteredData.map(item => `${item.id},"${item.name}"`).join('\n');
539
- const csvContent = 'data:text/csv;charset=utf-8,' + csvHeaders + csvRows;
540
-
541
- const encodedUri = encodeURI(csvContent);
542
- const link = document.createElement('a');
543
- link.setAttribute('href', encodedUri);
544
- link.setAttribute('download', 'esportazione_tabella.csv');
545
- document.body.appendChild(link);
546
- link.click();
547
- document.body.removeChild(link);
548
- };
549
- </script>
550
-
551
- <template>
552
- <div class="container my-4">
553
- <div class="form-group mb-3">
554
- <input v-model="searchFilter" type="text" class="form-control" placeholder="Cerca...">
555
- </div>
556
-
557
- <DataTableList
558
- :data-items="items"
559
- :data-table-conf="tableConfig"
560
- :filter="searchFilter"
561
- @ondownload="handleDownload"
562
- />
563
- </div>
564
- </template>
565
- ```
566
-
567
- ---
568
-
569
- ## 5. Dettagli Implementativi Importanti
570
-
571
- 1. **Identificativi Checkbox (`checkId`)**: Quando viene attivata la funzionalità checkbox (`showCheckbox = true`), il componente genera temporaneamente la chiave `checkId` all'interno dei record dell'array `dataItems` per identificare univocamente le righe selezionate. L'array restituito dall'evento `@onchecked` conterrà questi campi aggiuntivi.
572
- 2. **Reset dell'Ordinamento al cambio pagina**: Ad ogni navigazione di pagina (avanti o indietro) o reset del filtro di ricerca, viene richiamata la funzione `resetClassOrder()` che rimuove la classe CSS `.icon-primaryOrder` dall'header della colonna ordinata, indicando che la nuova pagina mostra i dati nel loro stato originario.
1
+ # 📊 DataTableList
2
+
3
+ ![Vue](https://img.shields.io/badge/Vue-3.x-42b883?logo=vue.js)
4
+ ![TypeScript](https://img.shields.io/badge/TypeScript-✔-3178c6?logo=typescript)
5
+ ![Version](https://img.shields.io/badge/version-1.0.3-blue) ![License](https://img.shields.io/badge/license-MIT-green)
6
+
7
+ ✨ Flessibile e completamente personalizzabile per la gestione di tabelle dati.
8
+
9
+ ---
10
+
11
+
12
+ ## 🚀 Features
13
+
14
+ - 🔍 **Filtro globale**
15
+ - 📄 **Paginazione** client & server
16
+ - ⬆️⬇️ **Ordinamento colonne**
17
+ - ✅ **Selezione multipla righe**
18
+ - ⚙️ **Azioni CRUD (View / Update / Delete)**
19
+ - 📥 **Download dati filtrati**
20
+ - 🎨 **Altamente customizzabile tramite slot**
21
+ - 🔄 **Supporto modalità server-side**
22
+
23
+ ---
24
+
25
+
26
+
27
+ # Guida all'Utilizzo e all'Implementazione di `DataTableList`
28
+
29
+ `DataTableList` è un componente riutilizzabile sviluppato in **Vue 3** (con TypeScript e Composition API). Offre una tabella dati flessibile con supporto nativo per paginazione, ordinamento, filtraggio, azioni di riga, esportazione dati, e selezione multipla tramite checkbox.
30
+
31
+ ---
32
+
33
+ [![downloads](https://img.shields.io/github/stars/badges/shields)](https://github.com/mssalvo/data-table-list-vue3) [npm version](https://npmjs.com)
34
+
35
+
36
+ ---
37
+
38
+ ## 📦 Setup
39
+
40
+ ```sh
41
+ npm install data-table-list@latest
42
+ ```
43
+
44
+ ---
45
+
46
+ ## 🎬 Demo
47
+
48
+ ![Preview](https://raw.githubusercontent.com/mssalvo/data-table-list-vue3/refs/heads/main/src/docs/datalist1.png)
49
+
50
+ ---
51
+
52
+ ![Preview](https://raw.githubusercontent.com/mssalvo/data-table-list-vue3/refs/heads/main/src/docs/datalist2.png)
53
+
54
+ ---
55
+
56
+ ![Preview](https://raw.githubusercontent.com/mssalvo/data-table-list-vue3/refs/heads/main/src/docs/datalist3.png)
57
+
58
+
59
+ ---
60
+
61
+
62
+ ## Offrimi un caffè
63
+
64
+ Se questo progetto ti è utile nel tuo lavoro, considera di supportarlo con un caffè ☕
65
+
66
+ 👉 [[https://paypal.me/msalvonet](https://paypal.me/msalvonet)]
67
+
68
+ Ogni supporto aiuta a mantenere e migliorare il progetto 🚀
69
+ ``
70
+
71
+
72
+
73
+ ---
74
+
75
+ ## usage
76
+
77
+
78
+ ```ts
79
+ import { DataTableList, Avatar } from 'data-table-list';
80
+ import type { DataTableConf } from 'data-table-list';
81
+ import 'data-table-list/dist/data-table-list.css'; // This imports the new stable CSS
82
+
83
+ ```
84
+
85
+
86
+ ---
87
+
88
+ ## 1. Strutture Dati e Interfacce (Modelli)
89
+
90
+ Il componente utilizza le seguenti interfacce TypeScript definite in [Models.ts](file:///c:/Users/UTENTE/Desktop/progettoIA/data-table-list/src/model/Models.ts):
91
+
92
+ ```ts
93
+ export interface DataTableConf {
94
+ columns: ColumnTable[]; // Configurazione delle colonne
95
+ actionsRow?: ActionRow; // Azioni di default abilitate per riga
96
+ viewActions: boolean; // Se mostrare o meno la colonna delle azioni
97
+ viewDownload?: boolean; // Se visualizzare il pulsante per il download/esportazione
98
+ paginator?: boolean; // Abilita la paginazione
99
+ paginatorPosition?: PaginatorPosition; // Posizione e allineamento del paginatore
100
+ isserver?: boolean; // Se la paginazione e il filtraggio sono gestiti lato server
101
+ serverPaging?: ServerPaging; // Metadati per la paginazione server-side
102
+ dimensionePagina: number; // Numero di righe per pagina
103
+ messageNotRecords?: string; // Messaggio mostrato se la tabella è vuota
104
+ }
105
+
106
+ export interface ColumnTable {
107
+ title: string; // Intestazione della colonna
108
+ property: string; // Nome della chiave nell'oggetto riga
109
+ style?: string | null; // Stile CSS inline da applicare alla cella (es: "width: 150px")
110
+ callFormatt?: Function | null; // Funzione custom per formattare il valore della cella
111
+ hidden?: boolean; // Nasconde la colonna se impostato a true
112
+ order?: boolean; // Abilita l'ordinamento client-side per questa colonna
113
+ }
114
+
115
+ export interface ActionRow {
116
+ view: boolean; // Mostra l'icona Visualizza (it-password-visible)
117
+ update: boolean; // Mostra l'icona Modifica (it-pencil)
118
+ delete: boolean; // Mostra l'icona Elimina (it-delete)
119
+ }
120
+
121
+ export interface PaginatorPosition {
122
+ top: boolean; // Mostra il paginatore sopra la tabella
123
+ bottom: boolean; // Mostra il paginatore sotto la tabella
124
+ class: string | 'center' | 'left' | 'right'; // Allineamento del paginatore ('left', 'center', 'right')
125
+ }
126
+
127
+ export interface ServerPaging {
128
+ serverTotaleElementi: number; // Numero totale di elementi sul server
129
+ serverTotalePagine: number; // Numero totale di pagine sul server
130
+ }
131
+ ```
132
+
133
+ ---
134
+
135
+ ## 2. API del Componente (Props ed Emits)
136
+
137
+ ### Props (Proprietà)
138
+
139
+ | Nome Prop | Tipo | Obbligatorio | Descrizione |
140
+ | :--- | :--- | :--- | :--- |
141
+ | `dataTableConf` | `DataTableConf` | **Sì** | Configurazione della struttura e del comportamento della tabella. |
142
+ | `dataItems` | `any[]` | **Sì** | Array di dati (righe) da visualizzare. Se `isserver` è `false`, contiene tutti i record. Se `isserver` è `true`, contiene solo i record della pagina corrente. |
143
+ | `filter` | `string` | No | Stringa di ricerca globale. Se specificata e `isserver` è `false`, la tabella esegue un filtro client-side su tutte le colonne visibili. |
144
+ | `showCheckbox` | `boolean` | No | Se impostato a `true`, aggiunge una prima colonna con checkbox per la selezione multipla delle righe. |
145
+
146
+ ### Emits (Eventi)
147
+
148
+ | Nome Evento | Parametri | Descrizione |
149
+ | :--- | :--- | :--- |
150
+ | `@onview` | `(obj: object)` | Emesso al click sul pulsante "Visualizza" della riga (default action). Riceve l'oggetto riga. |
151
+ | `@onupdate` | `(obj: object)` | Emesso al click sul pulsante "Modifica" della riga (default action). Riceve l'oggetto riga. |
152
+ | `@ondelete` | `(obj: object)` | Emesso al click sul pulsante "Elimina" della riga (default action). Riceve l'oggetto riga. |
153
+ | `@onavanti` | `(current: number, size: number)` | Emesso quando si va alla pagina successiva **solo se** `isserver` è `true`. `current` è l'indice di pagina (0-indexed), `size` è la dimensione della pagina. |
154
+ | `@onindietro` | `(current: number, size: number)` | Emesso quando si va alla pagina precedente **solo se** `isserver` è `true`. `current` è l'indice di pagina (0-indexed), `size` è la dimensione della pagina. |
155
+ | `@ondownload` | `(call: any[])` | Emesso al click sul pulsante di download. Riceve la lista corrente dei dati filtrati. |
156
+ | `@onchecked` | `(obj: any[])` | Emesso ogni volta che cambia la selezione delle righe tramite checkbox. Riceve l'array delle righe attualmente selezionate. |
157
+
158
+ ---
159
+
160
+ ## 3. Slot di Personalizzazione
161
+
162
+ `DataTableList` offre diversi slot con scoped-slots per personalizzare profondamente il markup:
163
+
164
+ * **`#columnTd`**: Permette di personalizzare il rendering del contenuto di ogni cella. Riceve `{ row, column }` come parametri dello slot.
165
+ * **`#iconTd`**: Consente di posizionare un'icona o un elemento decorativo a fianco del valore della cella. Riceve `{ row, column }`.
166
+ * **`#actions`**: Sostituisce i pulsanti di default (Visualizza, Modifica, Elimina) con pulsanti personalizzati o menu dropdown. Riceve `{ row }`.
167
+ * **`#checkbox`**: Sostituisce il checkbox di default delle righe. Riceve `{ row }`.
168
+ * **`#download`**: Personalizza l'aspetto del pulsante di download. Riceve l'evento `{ ondownload: { oncall: Function } }`.
169
+ * **`#iconView`**: Consente di sostituire l'icona menu view.
170
+ * **`#iconUpdate`**: Consente di sostituire l'icona menu update.
171
+ * **`#iconDelete`**: Consente di sostituire l'icona menu delete.
172
+ * **`#iconAvantiBottom`**: Consente di sostituire l'icona navigatore avanti con posizione bottom.
173
+ * **`#iconIndietroBottom`**: Consente di sostituire l'icona navigatore indietro con posizione bottom.
174
+ * **`#iconAvantiTop`**: Consente di sostituire l'icona navigatore avanti con posizione top.
175
+ * **`#iconIndietroTop`**: Consente di sostituire l'icona navigatore indietro con posizione top.
176
+
177
+ ---
178
+
179
+ ## 4. Scenari d'Uso ed Esempi di Implementazione
180
+
181
+ ### Scenario A: Tabella Semplice Client-Side con Paginazione e Ordinamento
182
+ In questo scenario, i dati sono interamente caricati in memoria. Il componente gestisce la paginazione, la ricerca globale e l'ordinamento in modo autonomo.
183
+
184
+ ```html
185
+ <script setup lang="ts">
186
+ import { ref } from 'vue';
187
+ import { DataTableList, Avatar } from 'data-table-list';
188
+ import type { DataTableConf } from 'data-table-list';
189
+ import 'data-table-list/dist/data-table-list.css';
190
+
191
+ const searchFilter = ref('');
192
+
193
+ const tableConfig = ref<DataTableConf>({
194
+ columns: [
195
+ { title: 'ID', property: 'id', order: true },
196
+ { title: 'Nome', property: 'name', order: true },
197
+ { title: 'Email', property: 'email', order: true }
198
+ ],
199
+ isserver: false,
200
+ paginator: true,
201
+ paginatorPosition: { top: true, bottom: true, class: 'right' },
202
+ viewActions: true,
203
+ actionsRow: { view: true, update: true, delete: true },
204
+ dimensionePagina: 5,
205
+ messageNotRecords: 'Nessun utente trovato.'
206
+ });
207
+
208
+ const items = ref([
209
+ { id: 1, name: 'Mario Rossi', email: 'mario.rossi@example.com' },
210
+ { id: 2, name: 'Giuseppe Verdi', email: 'giuseppe.verdi@example.com' },
211
+ { id: 3, name: 'Luca Bianchi', email: 'luca.bianchi@example.com' },
212
+ { id: 4, name: 'Anna Neri', email: 'anna.neri@example.com' },
213
+ { id: 5, name: 'Sofia Gialli', email: 'sofia.gialli@example.com' },
214
+ { id: 6, name: 'Elena Rosa', email: 'elena.rosa@example.com' }
215
+ ]);
216
+
217
+ const handleView = (item: any) => console.log('Visualizza:', item);
218
+ const handleUpdate = (item: any) => console.log('Modifica:', item);
219
+ const handleDelete = (item: any) => console.log('Elimina:', item);
220
+ </script>
221
+
222
+ <template>
223
+ <div class="container my-4">
224
+ <!-- Input di ricerca collegato alla prop :filter -->
225
+ <div class="form-group mb-3">
226
+ <label for="search">Cerca Utente</label>
227
+ <input id="search" v-model="searchFilter" type="text" class="form-control" placeholder="Cerca...">
228
+ </div>
229
+
230
+ <DataTableList
231
+ :data-items="items"
232
+ :data-table-conf="tableConfig"
233
+ :filter="searchFilter"
234
+ @onview="handleView"
235
+ @onupdate="handleUpdate"
236
+ @ondelete="handleDelete"
237
+ />
238
+ </div>
239
+ </template>
240
+ ```
241
+
242
+ ---
243
+
244
+ ### Scenario B: Formattazione Personalizzata di Colonne (`callFormatt`)
245
+ Quando si desidera applicare una formattazione al volo su una colonna (es. date, valute, o composizione stringhe) senza alterare i dati di origine, si può definire la funzione `callFormatt` nel modello `ColumnTable`.
246
+
247
+ ```ts
248
+ const tableConfig = ref<DataTableConf>({
249
+ columns: [
250
+ { title: 'ID', property: 'id' },
251
+ {
252
+ title: 'Nome Completo',
253
+ property: 'name',
254
+ // callFormatt riceve il valore del campo specificato in property e l'intera riga
255
+ callFormatt: (value: any, row: any) => {
256
+ return `${row.name.toUpperCase()} (${row.role})`;
257
+ }
258
+ },
259
+ {
260
+ title: 'Data Creazione',
261
+ property: 'createdAt',
262
+ callFormatt: (value: string) => {
263
+ return new Date(value).toLocaleDateString('it-IT');
264
+ }
265
+ }
266
+ ],
267
+ isserver: false,
268
+ viewActions: false,
269
+ dimensionePagina: 10
270
+ });
271
+
272
+ const items = ref([
273
+ { id: 1, name: 'Mario Rossi', role: 'Admin', createdAt: '2026-06-01T10:00:00Z' },
274
+ { id: 2, name: 'Giuseppe Verdi', role: 'User', createdAt: '2026-06-03T15:30:00Z' }
275
+ ]);
276
+ ```
277
+
278
+ ---
279
+
280
+ ### Scenario C: Personalizzazione Celle con Slot (`#columnTd` & Componenti Custom)
281
+ Se si necessita di inserire markup HTML complesso (es. Badge di stato, icone, o componenti esterni come `Avatar.vue`), si utilizza lo slot `#columnTd`.
282
+
283
+ ```html
284
+ <script setup lang="ts">
285
+ import { ref } from 'vue';
286
+ import { DataTableList, Avatar } from 'data-table-list';
287
+ import type { DataTableConf } from 'data-table-list';
288
+ import 'data-table-list/dist/data-table-list.css';
289
+
290
+ const tableConfig = ref<DataTableConf>({
291
+ columns: [
292
+ { title: 'Avatar', property: 'avatar', style: 'width: 80px;' },
293
+ { title: 'Dettagli Utente', property: 'details' },
294
+ { title: 'Stato', property: 'status' }
295
+ ],
296
+ isserver: false,
297
+ viewActions: false,
298
+ dimensionePagina: 5
299
+ });
300
+
301
+ const items = ref([
302
+ { id: 1, name: 'Mario Rossi', email: 'mario.rossi@example.com', status: 'Attivo', statusColor: 'bg-success' },
303
+ { id: 2, name: 'Giuseppe Verdi', email: 'giuseppe.verdi@example.com', status: 'Sospeso', statusColor: 'bg-warning' }
304
+ ]);
305
+ </script>
306
+
307
+ <template>
308
+ <DataTableList :data-items="items" :data-table-conf="tableConfig">
309
+ <!-- Utilizzo dello scoped slot per le celle -->
310
+ <template #columnTd="{ row, column }">
311
+
312
+ <!-- Cella Avatar -->
313
+ <div v-if="column.property === 'avatar'">
314
+ <Avatar
315
+ :label="row.name.charAt(0) + row.name.split(' ')[1]?.charAt(0)"
316
+ :background-dynamics="true"
317
+ />
318
+ </div>
319
+
320
+ <!-- Cella Dettagli Utente -->
321
+ <div v-else-if="column.property === 'details'">
322
+ <strong>{{ row.name }}</strong><br>
323
+ <small class="text-secondary">{{ row.email }}</small>
324
+ </div>
325
+
326
+ <!-- Cella Stato -->
327
+ <div v-else-if="column.property === 'status'">
328
+ <span class="badge rounded-pill text-white" :class="row.statusColor">
329
+ {{ row.status }}
330
+ </span>
331
+ </div>
332
+
333
+ </template>
334
+ </DataTableList>
335
+ </template>
336
+ ```
337
+
338
+ ---
339
+
340
+ ### Scenario D: Selezione Multipla con Checkbox e Evento `@onchecked`
341
+ Il componente supporta la selezione di elementi tramite una colonna di checkbox abilitata tramite la prop `:show-checkbox="true"`.
342
+
343
+ ```html
344
+ <script setup lang="ts">
345
+ import { ref } from 'vue';
346
+ import { DataTableList, Avatar } from 'data-table-list';
347
+ import type { DataTableConf } from 'data-table-list';
348
+ import 'data-table-list/dist/data-table-list.css';
349
+
350
+ const tableConfig = ref<DataTableConf>({
351
+ columns: [
352
+ { title: 'ID', property: 'id' },
353
+ { title: 'Prodotto', property: 'product' }
354
+ ],
355
+ isserver: false,
356
+ viewActions: false,
357
+ dimensionePagina: 10
358
+ });
359
+
360
+ const items = ref([
361
+ { id: 101, product: 'Computer Laptop' },
362
+ { id: 102, product: 'Monitor 4K' },
363
+ { id: 103, product: 'Tastiera Meccanica' }
364
+ ]);
365
+
366
+ const selectedItems = ref<any[]>([]);
367
+
368
+ // Salva gli elementi selezionati nello stato locale
369
+ const handleChecked = (checkedRows: any[]) => {
370
+ selectedItems.value = checkedRows;
371
+ console.log('Prodotti selezionati:', selectedItems.value);
372
+ };
373
+ </script>
374
+
375
+ <template>
376
+ <div class="my-3">
377
+ <DataTableList
378
+ :data-items="items"
379
+ :data-table-conf="tableConfig"
380
+ :show-checkbox="true"
381
+ @onchecked="handleChecked"
382
+ />
383
+
384
+ <div class="mt-3">
385
+ <h5>Elementi selezionati: {{ selectedItems.length }}</h5>
386
+ <ul>
387
+ <li v-for="item in selectedItems" :key="item.id">{{ item.product }}</li>
388
+ </ul>
389
+ </div>
390
+ </div>
391
+ </template>
392
+ ```
393
+
394
+ ---
395
+
396
+ ### Scenario E: Menu Azioni Personalizzato (Dropdown Bootstrap Italia)
397
+ Invece di mostrare i tre pulsanti standard in linea (view, update, delete), è possibile personalizzare la colonna delle azioni inserendo un menu a comparsa (dropdown) in perfetto stile Bootstrap Italia utilizzando lo slot `#actions`.
398
+
399
+ ```html
400
+ <script setup lang="ts">
401
+ import { ref } from 'vue';
402
+ import { DataTableList, Avatar } from 'data-table-list';
403
+ import type { DataTableConf } from 'data-table-list';
404
+ import 'data-table-list/dist/data-table-list.css';
405
+
406
+ const tableConfig = ref<DataTableConf>({
407
+ columns: [
408
+ { title: 'ID', property: 'id' },
409
+ { title: 'Documento', property: 'docName' }
410
+ ],
411
+ isserver: false,
412
+ viewActions: true, // Deve essere true per abilitare la colonna azioni
413
+ dimensionePagina: 10
414
+ });
415
+
416
+ const items = ref([
417
+ { id: 1, docName: 'Fattura_2026_01.pdf' },
418
+ { id: 2, docName: 'Contratto_Firmato.pdf' }
419
+ ]);
420
+
421
+ const scaricaDocumento = (row: any) => console.log('Download', row.docName);
422
+ const archiviaDocumento = (row: any) => console.log('Archivia', row.id);
423
+ </script>
424
+
425
+ <template>
426
+ <DataTableList :data-items="items" :data-table-conf="tableConfig">
427
+ <!-- Personalizzazione colonna azioni tramite slot -->
428
+ <template #actions="{ row }">
429
+ <div class="dropdown dropstart text-center">
430
+ <a class="btn btn-dropdown dropdown-toggle" href="#" role="button" id="dropdownActions" data-bs-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
431
+ <!-- Icona a tre pallini di Bootstrap Italia -->
432
+ <svg class="icon-expand icon icon-sm icon-secondary">
433
+ <use href="@/assets/svg/sprites.svg#it-more-items"></use>
434
+ </svg>
435
+ </a>
436
+ <div class="dropdown-menu" aria-labelledby="dropdownActions">
437
+ <div class="link-list-wrapper">
438
+ <ul class="link-list">
439
+ <li>
440
+ <a class="dropdown-item list-item" @click.prevent="scaricaDocumento(row)">
441
+ <span>
442
+ <svg class="icon icon-primary" aria-hidden="true">
443
+ <use href="@/assets/svg/sprites.svg#it-download"></use>
444
+ </svg> Scarica
445
+ </span>
446
+ </a>
447
+ </li>
448
+ <li>
449
+ <a class="dropdown-item list-item" @click.prevent="archiviaDocumento(row)">
450
+ <span>
451
+ <svg class="icon icon-primary" aria-hidden="true">
452
+ <use href="@/assets/svg/sprites.svg#it-box"></use>
453
+ </svg> Archivia
454
+ </span>
455
+ </a>
456
+ </li>
457
+ </ul>
458
+ </div>
459
+ </div>
460
+ </div>
461
+ </template>
462
+ </DataTableList>
463
+ </template>
464
+ ```
465
+
466
+ ---
467
+
468
+ ### Scenario F: Paginazione Server-Side (`isserver: true`)
469
+ Se la sorgente dati ha molti elementi, la paginazione deve avvenire sul server.
470
+ * `isserver` deve essere impostato a `true`.
471
+ * È necessario compilare `serverPaging` con i totali di elementi e pagine forniti dalle API.
472
+ * Bisogna ascoltare gli eventi `@onavanti` e `@onindietro` per richiedere la pagina corretta al server e aggiornare l'array `dataItems`.
473
+
474
+ ```html
475
+ <script setup lang="ts">
476
+ import { ref, onMounted } from 'vue';
477
+ import { DataTableList, Avatar } from 'data-table-list';
478
+ import type { DataTableConf } from 'data-table-list';
479
+ import 'data-table-list/dist/data-table-list.css';
480
+
481
+ // Stato locale per i dati e il caricamento
482
+ const items = ref<any[]>([]);
483
+ const loading = ref(false);
484
+
485
+ const tableConfig = ref<DataTableConf>({
486
+ columns: [
487
+ { title: 'ID', property: 'id' },
488
+ { title: 'Descrizione', property: 'description' }
489
+ ],
490
+ isserver: true, // Indica che paginazione e ricerca avvengono sul server
491
+ paginator: true,
492
+ paginatorPosition: { top: false, bottom: true, class: 'center' },
493
+ viewActions: false,
494
+ dimensionePagina: 10,
495
+ serverPaging: {
496
+ serverTotaleElementi: 0, // Inizializzato a 0, popolato in seguito
497
+ serverTotalePagine: 0
498
+ }
499
+ });
500
+
501
+ // Funzione simulata per caricare i dati dalle API
502
+ const fetchApiData = async (page: number, size: number) => {
503
+ loading.value = true;
504
+ try {
505
+ // Es. const res = await axios.get(`/api/items?page=${page}&size=${size}`);
506
+ await new Promise((resolve) => setTimeout(resolve, 400));
507
+
508
+ const mockTotalElements = 50;
509
+ const mockTotalPages = Math.ceil(mockTotalElements / size);
510
+
511
+ // Creazione dati simulati per la pagina corrente (es. pagina 0 -> ID 1-10)
512
+ const rows = [];
513
+ const start = page * size;
514
+ for (let i = 0; i < size; i++) {
515
+ const id = start + i + 1;
516
+ if (id <= mockTotalElements) {
517
+ rows.push({ id, description: `Elemento server ${id}` });
518
+ }
519
+ }
520
+
521
+ items.value = rows;
522
+
523
+ // Aggiornamento dei metadati di paginazione server-side
524
+ tableConfig.value.serverPaging = {
525
+ serverTotaleElementi: mockTotalElements,
526
+ serverTotalePagine: mockTotalPages
527
+ };
528
+ } finally {
529
+ loading.value = false;
530
+ }
531
+ };
532
+
533
+ // Gestione del cambio pagina in avanti
534
+ const handleAvanti = async (currentPage: number, size: number) => {
535
+ await fetchApiData(currentPage, size);
536
+ };
537
+
538
+ // Gestione del cambio pagina all'indietro
539
+ const handleIndietro = async (currentPage: number, size: number) => {
540
+ await fetchApiData(currentPage, size);
541
+ };
542
+
543
+ onMounted(async () => {
544
+ // Caricamento iniziale
545
+ await fetchApiData(0, tableConfig.value.dimensionePagina);
546
+ });
547
+ </script>
548
+
549
+ <template>
550
+ <div class="container my-4">
551
+ <h3>Paginazione Server-Side</h3>
552
+ <div v-if="loading" class="alert alert-info">Caricamento...</div>
553
+
554
+ <DataTableList
555
+ :data-items="items"
556
+ :data-table-conf="tableConfig"
557
+ @onavanti="handleAvanti"
558
+ @onindietro="handleIndietro"
559
+ />
560
+ </div>
561
+ </template>
562
+ ```
563
+
564
+ ---
565
+
566
+ ### Scenario G: Esportazione e Download dei Dati Filtrati
567
+ Il componente offre la possibilità di abilitare un pulsante per il download dei dati.
568
+ * Impostare `viewDownload: true` nella configurazione `DataTableConf`.
569
+ * Ascoltare l'evento `@ondownload`, che riceve la lista dei record attualmente filtrati dalla ricerca globale (`filterComputer`).
570
+
571
+ ```html
572
+ <script setup lang="ts">
573
+ import { ref } from 'vue';
574
+ import { DataTableList, Avatar } from 'data-table-list';
575
+ import type { DataTableConf } from 'data-table-list';
576
+ import 'data-table-list/dist/data-table-list.css';
577
+
578
+ const searchFilter = ref('');
579
+
580
+ const tableConfig = ref<DataTableConf>({
581
+ columns: [
582
+ { title: 'ID', property: 'id' },
583
+ { title: 'Nome', property: 'name' }
584
+ ],
585
+ isserver: false,
586
+ viewActions: false,
587
+ viewDownload: true, // Mostra l'icona per il download in alto a destra
588
+ dimensionePagina: 10
589
+ });
590
+
591
+ const items = ref([
592
+ { id: 1, name: 'Mario Rossi' },
593
+ { id: 2, name: 'Giuseppe Verdi' },
594
+ { id: 3, name: 'Luca Bianchi' }
595
+ ]);
596
+
597
+ // Funzione di esportazione CSV client-side al click sul download
598
+ const handleDownload = (filteredData: any[]) => {
599
+ const csvHeaders = 'ID,Nome\n';
600
+ const csvRows = filteredData.map(item => `${item.id},"${item.name}"`).join('\n');
601
+ const csvContent = 'data:text/csv;charset=utf-8,' + csvHeaders + csvRows;
602
+
603
+ const encodedUri = encodeURI(csvContent);
604
+ const link = document.createElement('a');
605
+ link.setAttribute('href', encodedUri);
606
+ link.setAttribute('download', 'esportazione_tabella.csv');
607
+ document.body.appendChild(link);
608
+ link.click();
609
+ document.body.removeChild(link);
610
+ };
611
+ </script>
612
+
613
+ <template>
614
+ <div class="container my-4">
615
+ <div class="form-group mb-3">
616
+ <input v-model="searchFilter" type="text" class="form-control" placeholder="Cerca...">
617
+ </div>
618
+
619
+ <DataTableList
620
+ :data-items="items"
621
+ :data-table-conf="tableConfig"
622
+ :filter="searchFilter"
623
+ @ondownload="handleDownload"
624
+ />
625
+ </div>
626
+ </template>
627
+ ```
628
+
629
+ ---
630
+
631
+ ## 5. Dettagli Implementativi Importanti
632
+
633
+ 1. **Identificativi Checkbox (`checkId`)**: Quando viene attivata la funzionalità checkbox (`showCheckbox = true`), il componente genera temporaneamente la chiave `checkId` all'interno dei record dell'array `dataItems` per identificare univocamente le righe selezionate. L'array restituito dall'evento `@onchecked` conterrà questi campi aggiuntivi.
634
+ 2. **Reset dell'Ordinamento al cambio pagina**: Ad ogni navigazione di pagina (avanti o indietro) o reset del filtro di ricerca, viene richiamata la funzione `resetClassOrder()` che rimuove la classe CSS `.icon-primaryOrder` dall'header della colonna ordinata, indicando che la nuova pagina mostra i dati nel loro stato originario.
635
+
636
+ ---
637
+
638
+ ## 🧑‍💻 Autore
639
+
640
+ **MSalvo**
641
+ 🔗 https://github.com/mssalvo
642
+
643
+ ---
644
+
645
+ ## 📄 Licenza
646
+
647
+ Distribuito sotto licenza MIT.
648
+ Vedi file LICENSE per dettagli.