11

Tabelle e dati

Nucleo comuneData & Tables

Dodici colonne, centinaia di righe, otto ore al giorno: la tabella non è un elenco di dati, è uno strumento.

Anatomia

Tabella, stato di riposo
Commessa ClienteResponsabileStatoImportoScadenza
C-4821Comune di RhoM. BianchiIn scadenza128.450,0028/06/2026
C-4820Immobiliare SestoL. FerriCompletata42.100,0014/06/2026
C-4817TecnoimpiantiA. RossiBloccata9.980,50—
C-4809Studio Marani—In attesa31.200,0011/07/2026
Intestazione in maiuscolo, colonna ordinata marcata, righe alterne al posto dei filetti, numeri a destra, stati a tratto, valore mancante con la lineetta, riga selezionata a filetto.
11.1La tabella ha il bordo esterno.struttura
11.2Alternanza oppure filetti, mai entrambi. Zebra in --row-alt da otto colonne in su, o quando la tabella scorre; sotto, filetti di riga.struttura
11.3L'alternanza è neutra, mai colorata.struttura
11.4Numeri, importi, date e ore: tabellari, a destra. Il testo a sinistra. Nessuna colonna centrata.nucleo
11.5Il valore mancante è una lineetta in --ink-300. Mai cella vuota, “N/D” o null.nucleo
11.6La prima colonna è bloccata quando la tabella scorre in orizzontale.struttura
11.7L'intestazione è sticky sopra le dieci righe, con --elev-raised solo mentre il contenuto le passa sotto.struttura
11.8La colonna ordinata si vede: intestazione in --ink-900 più la freccia nella dominante.nucleo
11.9La riga selezionata è un filetto, non una fascia. Bordo della dominante sopra, sotto e a sinistra; il fondo non cambia.struttura
11.10Massimo tre azioni di riga a icona, con tooltip. Dalla quarta, un menu.struttura
11.11Lo stato è un tag a tratto con la parola scritta. Mai un pallino da solo, mai una cella col fondo colorato.nucleo
11.12Una sola azione per clic sulla riga, dichiarata: apre il dettaglio oppure seleziona.nucleo
11.13Il footer dichiara il conteggio e il taglio: 18 di 247 a sinistra, paginazione a destra.struttura
11.14La densità è dell'utente e si ricorda. Comoda 44px, standard 36px, compatta 30px: cambia lo spazio, non il corpo.struttura

Le tre funzioni della tabella

Si chiedono sempre insieme, ma non hanno lo stesso costo: accenderle tutte e tre su una tabella da cinque colonne è controproducente.

FunzionePredefinitoCosto
Colonne nascondibiliSempre attiva. Le nostre tabelle superano le dieci colonne e nessuna schermata le mostra tutte beneUn comando in barra, nessuno spazio
Filtri di colonnaPresenti ma chiusi, dietro un burger in barraLa riga dei filtri costa 40px permanenti su ogni tabella: chi filtra per colonna lo fa in sessioni dedicate
Colonne spostabiliSi dichiara. Attiva d'ufficio su ERP, MES e WMS; altrove se il prodotto la chiedeDue gesti sullo stesso target e l'assistenza che non vede più la stessa schermata dell'utente
11.15Lo spostamento si fa nel pannello delle colonne, non trascinando l'intestazione.struttura
11.16Un mezzo alla volta, nessun filtro invisibile. Riga aperta: i filtri stanno lì, in barra solo il burger col conteggio. Riga chiusa: risalgono in barra come chip, raccolti in “+N”.nucleo
11.17Il ripristino è obbligatorio: Ripristina colonne in fondo al pannello, Azzera filtri accanto al conteggio.nucleo
11.18Il predefinito è una scelta, non l'ordine del database: quali colonne e in quale ordine si dichiara nel codice.struttura
11.19Colonne, ordine, larghezze, densità e filtri si ricordano per utente e per tabella. useLocalStorage vuole sempre un defaultValue.struttura
11.20La tabella non si configura a mano in una feature. Si usa il preset useMaeTable: le opzioni di questa sezione dichiarate una volta, non riconfigurate pagina per pagina — perché riconfigurate divergono, e divergono in silenzio.nucleo
Barra della tabella · riga dei filtri chiusa
Cerca commesseFiltri 3Cliente: RhoStato: 2+1 filtroAzzera filtri18 di 247Colonne 6/10
I chip non vanno a capo né si tagliano: quelli che non entrano si raccolgono con OverflowList.

Filtri per tipo di colonna

Tipo di colonnaFiltroComponente
TestoContieneTextInput
Numero, importoIntervallo da / aNumberInput × 2
DataIntervallo, con le scorciatoie del calendarioDatePickerInput type="range"
Elenco chiusoScelta multiplaMultiSelect
StatoI tag stessi, premibiliChip.Group

Nell'implementazione

Lo stack aziendale fissa mantine-datatable. Tutte le funzioni di questa sezione ci sono già: qui c'è come si configurano.

ConvenzioneDoveConfigurazione
TabellauseMantineReactTablemantineTableProps={{ withTableBorder: true, withRowBorders: false, striped: 'even' }}, oppure filetti e niente zebra sotto le otto colonne (11.2). Il colore della zebra viene da --row-alt, non da un colore di tema
Colonne nascondibilienableHidingSempre true (predefinito). initialState.columnVisibility dichiara le colonne predefinite: non è l'ordine del database (11.18)
Colonne spostabilienableColumnOrderingfalse per difetto, true su ERP, MES e WMS. Va disattivato enableColumnDragging sull'intestazione: lo spostamento si fa nel pannello (11.15)
Filtri di colonnaenableColumnFilterstrue con initialState.showColumnFilters: false — presenti ma chiusi. columnFilterDisplayMode: 'subheader'
Filtro per tipocolumnDef.filterVariant'text', 'range', 'date-range', 'multi-select' secondo la tabella qui sopra. Il predefinito è sempre 'text': va dichiarato colonna per colonna
Chip dei filtri attiviOverflowListNon c'è in MRT: si legge state.columnFilters e si rende in barra con OverflowList (Mantine 9) quando la riga dei filtri è chiusa (11.16)
DensitàenableDensityToggleTre passi già previsti. initialState.density: 'xs' per lo standard a 36px
Intestazione e prima colonnaenableStickyHeader
enableColumnPinning
Header sticky sopra le dieci righe. initialState.columnPinning.left con l'identificativo (11.6)
MemoriaonStateChangeColonne, ordine, larghezze, densità e filtri in useLocalStorage con defaultValue esplicito, chiave per utente e per tabella (11.19)
Azioni di rigaenableRowActionsrenderRowActions con ActionIcon variant="subtle". Oltre tre, Menu con IconDots
Empty staterenderEmptyRowsFallbackI quattro stati della sezione 14 — il predefinito di MRT è “No records to display”, che non ne è nessuno
Barre in lineaBarsListNuovo in Mantine 9. Classifiche e distribuzioni dentro una card, dove un grafico intero sarebbe sproporzionato
NucleoLa tabella non si riscrive. Riscriverla sopra Table è una variazione di stack da autorizzare (R2). Del gruppo è solo il preset: le opzioni qui sopra raccolte in un useMaeTable. mantine-datatable non si usa.

Grafici

RimandoRampe e uso del colore nei grafici: 5 · Sistema di colore. Qui una regola sola: un grafico serve quando le serie sono due o tre; una distribuzione con etichetta e valore è un elenco di barre.
Il perchéLe dodici regole originali e la loro argomentazione stanno in Disposizione; le decisioni sull'alternanza e sulle tre funzioni della griglia, con le dimostrazioni a due stati, nelle Correzioni v3, voci 05 e 11.