data-table-list 0.0.0 → 1.0.0

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.
Files changed (3) hide show
  1. package/DOCUMENTATION.md +561 -0
  2. package/README.md +13 -30
  3. package/package.json +3 -2
@@ -0,0 +1,561 @@
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
+ ## Project Setup
8
+
9
+ ```sh
10
+ npm install data-table-list@1.0.0
11
+ ```
12
+
13
+ ---
14
+
15
+ ## usage
16
+
17
+
18
+ ```ts
19
+ import { DataTableList, Avatar } from 'data-table-list';
20
+ import type { DataTableConf } from 'data-table-list';
21
+ import 'data-table-list/dist/data-table-list.css'; // This imports the new stable CSS
22
+
23
+ ```
24
+
25
+ ---
26
+
27
+ ## 1. Strutture Dati e Interfacce (Modelli)
28
+
29
+ Il componente utilizza le seguenti interfacce TypeScript definite in [Models.ts](file:///c:/Users/UTENTE/Desktop/progettoIA/data-table-list/src/model/Models.ts):
30
+
31
+ ```ts
32
+ export interface DataTableConf {
33
+ columns: ColumnTable[]; // Configurazione delle colonne
34
+ actionsRow?: ActionRow; // Azioni di default abilitate per riga
35
+ viewActions: boolean; // Se mostrare o meno la colonna delle azioni
36
+ viewDownload?: boolean; // Se visualizzare il pulsante per il download/esportazione
37
+ paginator?: boolean; // Abilita la paginazione
38
+ paginatorPosition?: PaginatorPosition; // Posizione e allineamento del paginatore
39
+ isserver?: boolean; // Se la paginazione e il filtraggio sono gestiti lato server
40
+ serverPaging?: ServerPaging; // Metadati per la paginazione server-side
41
+ dimensionePagina: number; // Numero di righe per pagina
42
+ messageNotRecords?: string; // Messaggio mostrato se la tabella è vuota
43
+ }
44
+
45
+ export interface ColumnTable {
46
+ title: string; // Intestazione della colonna
47
+ property: string; // Nome della chiave nell'oggetto riga
48
+ style?: string | null; // Stile CSS inline da applicare alla cella (es: "width: 150px")
49
+ callFormatt?: Function | null; // Funzione custom per formattare il valore della cella
50
+ hidden?: boolean; // Nasconde la colonna se impostato a true
51
+ order?: boolean; // Abilita l'ordinamento client-side per questa colonna
52
+ }
53
+
54
+ export interface ActionRow {
55
+ view: boolean; // Mostra l'icona Visualizza (it-password-visible)
56
+ update: boolean; // Mostra l'icona Modifica (it-pencil)
57
+ delete: boolean; // Mostra l'icona Elimina (it-delete)
58
+ }
59
+
60
+ export interface PaginatorPosition {
61
+ top: boolean; // Mostra il paginatore sopra la tabella
62
+ bottom: boolean; // Mostra il paginatore sotto la tabella
63
+ class: string | 'center' | 'left' | 'right'; // Allineamento del paginatore ('left', 'center', 'right')
64
+ }
65
+
66
+ export interface ServerPaging {
67
+ serverTotaleElementi: number; // Numero totale di elementi sul server
68
+ serverTotalePagine: number; // Numero totale di pagine sul server
69
+ }
70
+ ```
71
+
72
+ ---
73
+
74
+ ## 2. API del Componente (Props ed Emits)
75
+
76
+ ### Props (Proprietà)
77
+
78
+ | Nome Prop | Tipo | Obbligatorio | Descrizione |
79
+ | :--- | :--- | :--- | :--- |
80
+ | `dataTableConf` | `DataTableConf` | **Sì** | Configurazione della struttura e del comportamento della tabella. |
81
+ | `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. |
82
+ | `filter` | `string` | No | Stringa di ricerca globale. Se specificata e `isserver` è `false`, la tabella esegue un filtro client-side su tutte le colonne visibili. |
83
+ | `showCheckbox` | `boolean` | No | Se impostato a `true`, aggiunge una prima colonna con checkbox per la selezione multipla delle righe. |
84
+
85
+ ### Emits (Eventi)
86
+
87
+ | Nome Evento | Parametri | Descrizione |
88
+ | :--- | :--- | :--- |
89
+ | `@onview` | `(obj: object)` | Emesso al click sul pulsante "Visualizza" della riga (default action). Riceve l'oggetto riga. |
90
+ | `@onupdate` | `(obj: object)` | Emesso al click sul pulsante "Modifica" della riga (default action). Riceve l'oggetto riga. |
91
+ | `@ondelete` | `(obj: object)` | Emesso al click sul pulsante "Elimina" della riga (default action). Riceve l'oggetto riga. |
92
+ | `@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. |
93
+ | `@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. |
94
+ | `@ondownload` | `(call: any[])` | Emesso al click sul pulsante di download. Riceve la lista corrente dei dati filtrati. |
95
+ | `@onchecked` | `(obj: any[])` | Emesso ogni volta che cambia la selezione delle righe tramite checkbox. Riceve l'array delle righe attualmente selezionate. |
96
+
97
+ ---
98
+
99
+ ## 3. Slot di Personalizzazione
100
+
101
+ `DataTableList` offre diversi slot con scoped-slots per personalizzare profondamente il markup:
102
+
103
+ * **`#columnTd`**: Permette di personalizzare il rendering del contenuto di ogni cella. Riceve `{ row, column }` come parametri dello slot.
104
+ * **`#iconTd`**: Consente di posizionare un'icona o un elemento decorativo a fianco del valore della cella. Riceve `{ row, column }`.
105
+ * **`#actions`**: Sostituisce i pulsanti di default (Visualizza, Modifica, Elimina) con pulsanti personalizzati o menu dropdown. Riceve `{ row }`.
106
+ * **`#checkbox`**: Sostituisce il checkbox di default delle righe. Riceve `{ row }`.
107
+ * **`#download`**: Personalizza l'aspetto del pulsante di download. Riceve l'evento `{ ondownload: { oncall: Function } }`.
108
+
109
+ ---
110
+
111
+ ## 4. Scenari d'Uso ed Esempi di Implementazione
112
+
113
+ ### Scenario A: Tabella Semplice Client-Side con Paginazione e Ordinamento
114
+ In questo scenario, i dati sono interamente caricati in memoria. Il componente gestisce la paginazione, la ricerca globale e l'ordinamento in modo autonomo.
115
+
116
+ ```html
117
+ <script setup lang="ts">
118
+ import { ref } from 'vue';
119
+ import DataTableList from '@/component/commons/DataTableList.vue';
120
+ import type { DataTableConf } from '@/model/Models';
121
+
122
+ const searchFilter = ref('');
123
+
124
+ const tableConfig = ref<DataTableConf>({
125
+ columns: [
126
+ { title: 'ID', property: 'id', order: true },
127
+ { title: 'Nome', property: 'name', order: true },
128
+ { title: 'Email', property: 'email', order: true }
129
+ ],
130
+ isserver: false,
131
+ paginator: true,
132
+ paginatorPosition: { top: true, bottom: true, class: 'right' },
133
+ viewActions: true,
134
+ actionsRow: { view: true, update: true, delete: true },
135
+ dimensionePagina: 5,
136
+ messageNotRecords: 'Nessun utente trovato.'
137
+ });
138
+
139
+ const items = ref([
140
+ { id: 1, name: 'Mario Rossi', email: 'mario.rossi@example.com' },
141
+ { id: 2, name: 'Giuseppe Verdi', email: 'giuseppe.verdi@example.com' },
142
+ { id: 3, name: 'Luca Bianchi', email: 'luca.bianchi@example.com' },
143
+ { id: 4, name: 'Anna Neri', email: 'anna.neri@example.com' },
144
+ { id: 5, name: 'Sofia Gialli', email: 'sofia.gialli@example.com' },
145
+ { id: 6, name: 'Elena Rosa', email: 'elena.rosa@example.com' }
146
+ ]);
147
+
148
+ const handleView = (item: any) => console.log('Visualizza:', item);
149
+ const handleUpdate = (item: any) => console.log('Modifica:', item);
150
+ const handleDelete = (item: any) => console.log('Elimina:', item);
151
+ </script>
152
+
153
+ <template>
154
+ <div class="container my-4">
155
+ <!-- Input di ricerca collegato alla prop :filter -->
156
+ <div class="form-group mb-3">
157
+ <label for="search">Cerca Utente</label>
158
+ <input id="search" v-model="searchFilter" type="text" class="form-control" placeholder="Cerca...">
159
+ </div>
160
+
161
+ <DataTableList
162
+ :data-items="items"
163
+ :data-table-conf="tableConfig"
164
+ :filter="searchFilter"
165
+ @onview="handleView"
166
+ @onupdate="handleUpdate"
167
+ @ondelete="handleDelete"
168
+ />
169
+ </div>
170
+ </template>
171
+ ```
172
+
173
+ ---
174
+
175
+ ### Scenario B: Formattazione Personalizzata di Colonne (`callFormatt`)
176
+ 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`.
177
+
178
+ ```ts
179
+ const tableConfig = ref<DataTableConf>({
180
+ columns: [
181
+ { title: 'ID', property: 'id' },
182
+ {
183
+ title: 'Nome Completo',
184
+ property: 'name',
185
+ // callFormatt riceve il valore del campo specificato in property e l'intera riga
186
+ callFormatt: (value: any, row: any) => {
187
+ return `${row.name.toUpperCase()} (${row.role})`;
188
+ }
189
+ },
190
+ {
191
+ title: 'Data Creazione',
192
+ property: 'createdAt',
193
+ callFormatt: (value: string) => {
194
+ return new Date(value).toLocaleDateString('it-IT');
195
+ }
196
+ }
197
+ ],
198
+ isserver: false,
199
+ viewActions: false,
200
+ dimensionePagina: 10
201
+ });
202
+
203
+ const items = ref([
204
+ { id: 1, name: 'Mario Rossi', role: 'Admin', createdAt: '2026-06-01T10:00:00Z' },
205
+ { id: 2, name: 'Giuseppe Verdi', role: 'User', createdAt: '2026-06-03T15:30:00Z' }
206
+ ]);
207
+ ```
208
+
209
+ ---
210
+
211
+ ### Scenario C: Personalizzazione Celle con Slot (`#columnTd` & Componenti Custom)
212
+ Se si necessita di inserire markup HTML complesso (es. Badge di stato, icone, o componenti esterni come `Avatar.vue`), si utilizza lo slot `#columnTd`.
213
+
214
+ ```html
215
+ <script setup lang="ts">
216
+ import { ref } from 'vue';
217
+ import DataTableList from '@/component/commons/DataTableList.vue';
218
+ import Avatar from '@/component/commons/Avatar.vue';
219
+ import type { DataTableConf } from '@/model/Models';
220
+
221
+ const tableConfig = ref<DataTableConf>({
222
+ columns: [
223
+ { title: 'Avatar', property: 'avatar', style: 'width: 80px;' },
224
+ { title: 'Dettagli Utente', property: 'details' },
225
+ { title: 'Stato', property: 'status' }
226
+ ],
227
+ isserver: false,
228
+ viewActions: false,
229
+ dimensionePagina: 5
230
+ });
231
+
232
+ const items = ref([
233
+ { id: 1, name: 'Mario Rossi', email: 'mario.rossi@example.com', status: 'Attivo', statusColor: 'bg-success' },
234
+ { id: 2, name: 'Giuseppe Verdi', email: 'giuseppe.verdi@example.com', status: 'Sospeso', statusColor: 'bg-warning' }
235
+ ]);
236
+ </script>
237
+
238
+ <template>
239
+ <DataTableList :data-items="items" :data-table-conf="tableConfig">
240
+ <!-- Utilizzo dello scoped slot per le celle -->
241
+ <template #columnTd="{ row, column }">
242
+
243
+ <!-- Cella Avatar -->
244
+ <div v-if="column.property === 'avatar'">
245
+ <Avatar
246
+ :label="row.name.charAt(0) + row.name.split(' ')[1]?.charAt(0)"
247
+ :background-dynamics="true"
248
+ />
249
+ </div>
250
+
251
+ <!-- Cella Dettagli Utente -->
252
+ <div v-else-if="column.property === 'details'">
253
+ <strong>{{ row.name }}</strong><br>
254
+ <small class="text-secondary">{{ row.email }}</small>
255
+ </div>
256
+
257
+ <!-- Cella Stato -->
258
+ <div v-else-if="column.property === 'status'">
259
+ <span class="badge rounded-pill text-white" :class="row.statusColor">
260
+ {{ row.status }}
261
+ </span>
262
+ </div>
263
+
264
+ </template>
265
+ </DataTableList>
266
+ </template>
267
+ ```
268
+
269
+ ---
270
+
271
+ ### Scenario D: Selezione Multipla con Checkbox e Evento `@onchecked`
272
+ Il componente supporta la selezione di elementi tramite una colonna di checkbox abilitata tramite la prop `:show-checkbox="true"`.
273
+
274
+ ```html
275
+ <script setup lang="ts">
276
+ import { ref } from 'vue';
277
+ import DataTableList from '@/component/commons/DataTableList.vue';
278
+ import type { DataTableConf } from '@/model/Models';
279
+
280
+ const tableConfig = ref<DataTableConf>({
281
+ columns: [
282
+ { title: 'ID', property: 'id' },
283
+ { title: 'Prodotto', property: 'product' }
284
+ ],
285
+ isserver: false,
286
+ viewActions: false,
287
+ dimensionePagina: 10
288
+ });
289
+
290
+ const items = ref([
291
+ { id: 101, product: 'Computer Laptop' },
292
+ { id: 102, product: 'Monitor 4K' },
293
+ { id: 103, product: 'Tastiera Meccanica' }
294
+ ]);
295
+
296
+ const selectedItems = ref<any[]>([]);
297
+
298
+ // Salva gli elementi selezionati nello stato locale
299
+ const handleChecked = (checkedRows: any[]) => {
300
+ selectedItems.value = checkedRows;
301
+ console.log('Prodotti selezionati:', selectedItems.value);
302
+ };
303
+ </script>
304
+
305
+ <template>
306
+ <div class="my-3">
307
+ <DataTableList
308
+ :data-items="items"
309
+ :data-table-conf="tableConfig"
310
+ :show-checkbox="true"
311
+ @onchecked="handleChecked"
312
+ />
313
+
314
+ <div class="mt-3">
315
+ <h5>Elementi selezionati: {{ selectedItems.length }}</h5>
316
+ <ul>
317
+ <li v-for="item in selectedItems" :key="item.id">{{ item.product }}</li>
318
+ </ul>
319
+ </div>
320
+ </div>
321
+ </template>
322
+ ```
323
+
324
+ ---
325
+
326
+ ### Scenario E: Menu Azioni Personalizzato (Dropdown Bootstrap Italia)
327
+ 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`.
328
+
329
+ ```html
330
+ <script setup lang="ts">
331
+ import { ref } from 'vue';
332
+ import DataTableList from '@/component/commons/DataTableList.vue';
333
+ import type { DataTableConf } from '@/model/Models';
334
+
335
+ const tableConfig = ref<DataTableConf>({
336
+ columns: [
337
+ { title: 'ID', property: 'id' },
338
+ { title: 'Documento', property: 'docName' }
339
+ ],
340
+ isserver: false,
341
+ viewActions: true, // Deve essere true per abilitare la colonna azioni
342
+ dimensionePagina: 10
343
+ });
344
+
345
+ const items = ref([
346
+ { id: 1, docName: 'Fattura_2026_01.pdf' },
347
+ { id: 2, docName: 'Contratto_Firmato.pdf' }
348
+ ]);
349
+
350
+ const scaricaDocumento = (row: any) => console.log('Download', row.docName);
351
+ const archiviaDocumento = (row: any) => console.log('Archivia', row.id);
352
+ </script>
353
+
354
+ <template>
355
+ <DataTableList :data-items="items" :data-table-conf="tableConfig">
356
+ <!-- Personalizzazione colonna azioni tramite slot -->
357
+ <template #actions="{ row }">
358
+ <div class="dropdown dropstart text-center">
359
+ <a class="btn btn-dropdown dropdown-toggle" href="#" role="button" id="dropdownActions" data-bs-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
360
+ <!-- Icona a tre pallini di Bootstrap Italia -->
361
+ <svg class="icon-expand icon icon-sm icon-secondary">
362
+ <use href="@/assets/svg/sprites.svg#it-more-items"></use>
363
+ </svg>
364
+ </a>
365
+ <div class="dropdown-menu" aria-labelledby="dropdownActions">
366
+ <div class="link-list-wrapper">
367
+ <ul class="link-list">
368
+ <li>
369
+ <a class="dropdown-item list-item" @click.prevent="scaricaDocumento(row)">
370
+ <span>
371
+ <svg class="icon icon-primary" aria-hidden="true">
372
+ <use href="@/assets/svg/sprites.svg#it-download"></use>
373
+ </svg> Scarica
374
+ </span>
375
+ </a>
376
+ </li>
377
+ <li>
378
+ <a class="dropdown-item list-item" @click.prevent="archiviaDocumento(row)">
379
+ <span>
380
+ <svg class="icon icon-primary" aria-hidden="true">
381
+ <use href="@/assets/svg/sprites.svg#it-box"></use>
382
+ </svg> Archivia
383
+ </span>
384
+ </a>
385
+ </li>
386
+ </ul>
387
+ </div>
388
+ </div>
389
+ </div>
390
+ </template>
391
+ </DataTableList>
392
+ </template>
393
+ ```
394
+
395
+ ---
396
+
397
+ ### Scenario F: Paginazione Server-Side (`isserver: true`)
398
+ Se la sorgente dati ha molti elementi, la paginazione deve avvenire sul server.
399
+ * `isserver` deve essere impostato a `true`.
400
+ * È necessario compilare `serverPaging` con i totali di elementi e pagine forniti dalle API.
401
+ * Bisogna ascoltare gli eventi `@onavanti` e `@onindietro` per richiedere la pagina corretta al server e aggiornare l'array `dataItems`.
402
+
403
+ ```html
404
+ <script setup lang="ts">
405
+ import { ref, onMounted } from 'vue';
406
+ import DataTableList from '@/component/commons/DataTableList.vue';
407
+ import type { DataTableConf } from '@/model/Models';
408
+
409
+ // Stato locale per i dati e il caricamento
410
+ const items = ref<any[]>([]);
411
+ const loading = ref(false);
412
+
413
+ const tableConfig = ref<DataTableConf>({
414
+ columns: [
415
+ { title: 'ID', property: 'id' },
416
+ { title: 'Descrizione', property: 'description' }
417
+ ],
418
+ isserver: true, // Indica che paginazione e ricerca avvengono sul server
419
+ paginator: true,
420
+ paginatorPosition: { top: false, bottom: true, class: 'center' },
421
+ viewActions: false,
422
+ dimensionePagina: 10,
423
+ serverPaging: {
424
+ serverTotaleElementi: 0, // Inizializzato a 0, popolato in seguito
425
+ serverTotalePagine: 0
426
+ }
427
+ });
428
+
429
+ // Funzione simulata per caricare i dati dalle API
430
+ const fetchApiData = async (page: number, size: number) => {
431
+ loading.value = true;
432
+ try {
433
+ // Es. const res = await axios.get(`/api/items?page=${page}&size=${size}`);
434
+ await new Promise((resolve) => setTimeout(resolve, 400));
435
+
436
+ const mockTotalElements = 50;
437
+ const mockTotalPages = Math.ceil(mockTotalElements / size);
438
+
439
+ // Creazione dati simulati per la pagina corrente (es. pagina 0 -> ID 1-10)
440
+ const rows = [];
441
+ const start = page * size;
442
+ for (let i = 0; i < size; i++) {
443
+ const id = start + i + 1;
444
+ if (id <= mockTotalElements) {
445
+ rows.push({ id, description: `Elemento server ${id}` });
446
+ }
447
+ }
448
+
449
+ items.value = rows;
450
+
451
+ // Aggiornamento dei metadati di paginazione server-side
452
+ tableConfig.value.serverPaging = {
453
+ serverTotaleElementi: mockTotalElements,
454
+ serverTotalePagine: mockTotalPages
455
+ };
456
+ } finally {
457
+ loading.value = false;
458
+ }
459
+ };
460
+
461
+ // Gestione del cambio pagina in avanti
462
+ const handleAvanti = async (currentPage: number, size: number) => {
463
+ await fetchApiData(currentPage, size);
464
+ };
465
+
466
+ // Gestione del cambio pagina all'indietro
467
+ const handleIndietro = async (currentPage: number, size: number) => {
468
+ await fetchApiData(currentPage, size);
469
+ };
470
+
471
+ onMounted(async () => {
472
+ // Caricamento iniziale
473
+ await fetchApiData(0, tableConfig.value.dimensionePagina);
474
+ });
475
+ </script>
476
+
477
+ <template>
478
+ <div class="container my-4">
479
+ <h3>Paginazione Server-Side</h3>
480
+ <div v-if="loading" class="alert alert-info">Caricamento...</div>
481
+
482
+ <DataTableList
483
+ :data-items="items"
484
+ :data-table-conf="tableConfig"
485
+ @onavanti="handleAvanti"
486
+ @onindietro="handleIndietro"
487
+ />
488
+ </div>
489
+ </template>
490
+ ```
491
+
492
+ ---
493
+
494
+ ### Scenario G: Esportazione e Download dei Dati Filtrati
495
+ Il componente offre la possibilità di abilitare un pulsante per il download dei dati.
496
+ * Impostare `viewDownload: true` nella configurazione `DataTableConf`.
497
+ * Ascoltare l'evento `@ondownload`, che riceve la lista dei record attualmente filtrati dalla ricerca globale (`filterComputer`).
498
+
499
+ ```html
500
+ <script setup lang="ts">
501
+ import { ref } from 'vue';
502
+ import DataTableList from '@/component/commons/DataTableList.vue';
503
+ import type { DataTableConf } from '@/model/Models';
504
+
505
+ const searchFilter = ref('');
506
+
507
+ const tableConfig = ref<DataTableConf>({
508
+ columns: [
509
+ { title: 'ID', property: 'id' },
510
+ { title: 'Nome', property: 'name' }
511
+ ],
512
+ isserver: false,
513
+ viewActions: false,
514
+ viewDownload: true, // Mostra l'icona per il download in alto a destra
515
+ dimensionePagina: 10
516
+ });
517
+
518
+ const items = ref([
519
+ { id: 1, name: 'Mario Rossi' },
520
+ { id: 2, name: 'Giuseppe Verdi' },
521
+ { id: 3, name: 'Luca Bianchi' }
522
+ ]);
523
+
524
+ // Funzione di esportazione CSV client-side al click sul download
525
+ const handleDownload = (filteredData: any[]) => {
526
+ const csvHeaders = 'ID,Nome\n';
527
+ const csvRows = filteredData.map(item => `${item.id},"${item.name}"`).join('\n');
528
+ const csvContent = 'data:text/csv;charset=utf-8,' + csvHeaders + csvRows;
529
+
530
+ const encodedUri = encodeURI(csvContent);
531
+ const link = document.createElement('a');
532
+ link.setAttribute('href', encodedUri);
533
+ link.setAttribute('download', 'esportazione_tabella.csv');
534
+ document.body.appendChild(link);
535
+ link.click();
536
+ document.body.removeChild(link);
537
+ };
538
+ </script>
539
+
540
+ <template>
541
+ <div class="container my-4">
542
+ <div class="form-group mb-3">
543
+ <input v-model="searchFilter" type="text" class="form-control" placeholder="Cerca...">
544
+ </div>
545
+
546
+ <DataTableList
547
+ :data-items="items"
548
+ :data-table-conf="tableConfig"
549
+ :filter="searchFilter"
550
+ @ondownload="handleDownload"
551
+ />
552
+ </div>
553
+ </template>
554
+ ```
555
+
556
+ ---
557
+
558
+ ## 5. Dettagli Implementativi Importanti
559
+
560
+ 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.
561
+ 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.
package/README.md CHANGED
@@ -1,42 +1,25 @@
1
- # neuto
1
+ # data-table-list
2
2
 
3
- This template should help get you started developing with Vue 3 in Vite.
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
4
 
5
- ## Recommended IDE Setup
6
-
7
- [VS Code](https://code.visualstudio.com/) + [Vue (Official)](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur).
8
-
9
- ## Recommended Browser Setup
10
-
11
- - Chromium-based browsers (Chrome, Edge, Brave, etc.):
12
- - [Vue.js devtools](https://chromewebstore.google.com/detail/vuejs-devtools/nhdogjmejiglipccpnnnanhbledajbpd)
13
- - [Turn on Custom Object Formatter in Chrome DevTools](http://bit.ly/object-formatters)
14
- - Firefox:
15
- - [Vue.js devtools](https://addons.mozilla.org/en-US/firefox/addon/vue-js-devtools/)
16
- - [Turn on Custom Object Formatter in Firefox DevTools](https://fxdx.dev/firefox-devtools-custom-object-formatters/)
17
-
18
- ## Type Support for `.vue` Imports in TS
19
-
20
- TypeScript cannot handle type information for `.vue` imports by default, so we replace the `tsc` CLI with `vue-tsc` for type checking. In editors, we need [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) to make the TypeScript language service aware of `.vue` types.
21
-
22
- ## Customize configuration
23
-
24
- See [Vite Configuration Reference](https://vite.dev/config/).
5
+ ---
25
6
 
26
7
  ## Project Setup
27
8
 
28
9
  ```sh
29
- npm install
10
+ npm install data-table-list
30
11
  ```
31
12
 
32
- ### Compile and Hot-Reload for Development
13
+ ---
33
14
 
34
- ```sh
35
- npm run dev
36
- ```
15
+ ## usage
37
16
 
38
- ### Type-Check, Compile and Minify for Production
39
17
 
40
- ```sh
41
- npm run build
18
+ ```ts
19
+ import { DataTableList, Avatar } from 'data-table-list';
20
+ import type { DataTableConf } from 'data-table-list';
21
+ import 'data-table-list/dist/data-table-list.css'; // This imports the new stable CSS
22
+
42
23
  ```
24
+
25
+ ---
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "data-table-list",
3
- "version": "0.0.0",
3
+ "version": "1.0.0",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "main": "./dist/data-table-list.umd.cjs",
@@ -15,7 +15,8 @@
15
15
  "./dist/data-table-list.css": "./dist/data-table-list.css"
16
16
  },
17
17
  "files": [
18
- "dist"
18
+ "dist",
19
+ "DOCUMENTATION.md"
19
20
  ],
20
21
  "scripts": {
21
22
  "dev": "vite",