Comportamento

Cosa succede, non come appare. Sono le situazioni in cui due sedi diverse, senza una regola scritta, decidono in due modi diversi — e l'utente se ne accorge subito.

Tutto ciò che segue è nucleo: non si deroga. Un prodotto del gruppo si riconosce da qui, non dal colore.

1 · Quando non ci sono dati

Una tabella vuota non è una situazione sola: sono quattro stati distinti, e l'utente deve capire in quale si trova senza chiedere. Trattarli tutti come "nessun dato" è l'errore più comune, perché lascia l'utente senza sapere se aspettare, cambiare filtro o chiamare l'assistenza.

A · Non c'è ancora niente
CodiceClienteStato
Nessuna commessa
Le commesse che crei compaiono qui.
B · Il filtro non trova niente
CodiceClienteStato
Nessun risultato per “Rho”
Con i filtri Stato: bloccata e Sede: Milano non ci sono commesse.
C · Il caricamento è fallito
CodiceClienteStato
Non è stato possibile caricare le commesse
Il server non ha risposto. I dati non sono andati persi.
D · Sta caricando
CodiceClienteStato
NucleoOgni stato vuoto dice tre cose: perché è vuoto, cosa può farci l'utente, e con quale pulsante. Uno stato vuoto senza azione è ammesso solo nel caso A quando l'utente non ha i permessi per creare.
NucleoLo stato "filtro senza risultati" nomina i filtri attivi e offre di azzerarli. È la causa più frequente di chiamate all'assistenza: l'utente ha lasciato un filtro attivo da ieri e crede che i dati siano spariti.
NucleoL'errore di caricamento non si confonde con l'assenza di dati. Porta il colore danger sull'icona, dice che i dati non sono persi, e offre Riprova — che ricarica solo quella sezione, non l'intera pagina.
NucleoSotto 300ms non si mostra niente: un indicatore che lampeggia è peggio di una breve pausa. Sopra, sagome nella forma del contenuto atteso — tre righe di tabella, non un cerchio che gira. La pagina non deve saltare quando i dati arrivano, quindi le sagome hanno l'altezza delle righe vere.

Non solo tabelle

Campo di un dettaglioTrattino lungo — in grigio medio. Mai cella vuota, mai "N/D", mai zero al posto del nulla: 0,00 € e "nessun importo" sono fatti diversi.
Grafico senza datiAssi disegnati e messaggio al centro. Un riquadro bianco non dice se è vuoto o rotto.
Elenco a discesa vuoto"Nessuna sede disponibile" dentro il menu aperto, non un menu che si apre vuoto.
Ricerca globaleStato B: nomina il termine cercato e suggerisce cosa provare.

2 · Avviso o notifica

Due componenti diversi che vengono spesso scambiati. La distinzione è una sola domanda: l'utente può perdersi questo messaggio?

Avviso — resta nella pagina
! Certificato in scadenzaScade il 14/07/2026. Rinnovalo per non bloccare le lavorazioni.
! Non è stato possibile salvareIl codice C-4821 è già assegnato a un'altra commessa.
Per ciò che riguarda il contenuto della pagina e per gli errori che hanno impedito un'operazione. Sta dove l'utente stava lavorando — in cima al form, dentro il dialogo — e non sparisce da solo.
Notifica — passa in alto a destra
✓ Commessa creataC-4822 · Comune di Rho
i Esportazione avviataRiceverai il file via email fra pochi minuti.
Per confermare che un'azione è andata a buon fine. L'utente ha appena agito, quindi sta guardando: il messaggio può sparire. Non porta mai informazioni che servono dopo.
NucleoUn errore che ha impedito un'operazione non è mai una notifica. Se il salvataggio è fallito, il messaggio deve restare accanto al form: una notifica che sparisce dopo quattro secondi lascia l'utente convinto di aver salvato. La notifica di errore è ammessa solo per operazioni in secondo piano (un'esportazione fallita), e in quel caso non si chiude da sola.
Quale componente, quando
SituazioneComponenteDurataColore
Salvataggio riuscitoNotifica4 secondisuccess
Salvataggio fallitoAvviso sopra il formfino alla correzionedanger
Errori di validazioneSotto ogni campofino alla correzionedanger
Record in scadenza o incompletoAvviso in cima al contenutofinché la condizione durawarning
Record in sola lettura o archiviatoAvviso in cima al contenutopermanenteinfo
Operazione lunga avviataNotifica4 secondiinfo
Operazione in secondo piano fallitaNotificamanualedanger
Elemento eliminatoNotifica con “Annulla”5 secondineutro
Sessione in scadenzaDialogofino alla rispostawarning
NucleoMai più di tre notifiche in pila, e mai una notifica per ogni riga di un'operazione di massa: se elimini 40 righe, la notifica è una sola e dice "40 commesse eliminate".

3 · Testi parlanti

La regola sotto tutte le altre: il testo dice cosa fare, non cosa è andato storto. Chi legge deve poter agire senza interpretare.

Errori

×
Errore: campo non valido
Dice che c'è un problema, non quale né dove.
×
Il campo Partita IVA non è valido
Dice quale, ma non come rimediare. L'utente riprova a caso.
✓
La partita IVA deve avere 11 cifre
Dice la condizione da soddisfare. L'utente sa cosa correggere.
×
Errore 500 — Internal Server Error
Linguaggio di sistema esposto all'utente.
×
Si è verificato un errore imprevisto
Cortese e inutile: non dice se riprovare, né se i dati sono persi.
✓
Non è stato possibile salvare la commessa. Le modifiche sono ancora qui: riprova fra qualche istante.
Dice cosa non è successo, rassicura sui dati, indica l'azione. Il codice tecnico va nel registro, non a schermo.

Pulsanti

×
OK · Sì · Conferma
Chi legge solo il pulsante non sa cosa sta per succedere.
✓
Crea commessa · Salva · Elimina definitivamente
Il pulsante nomina l'azione. Vale soprattutto nei dialoghi di conferma.
Regole di scrittura
AspettoRegolaEsempio
PersonaSi dà del tu, in tono professionale e asciutto. Mai il “lei”, mai il “noi” aziendale.“Rinnovalo per non bloccare le lavorazioni”
PulsantiVerbo all'infinito + oggetto, se l'oggetto non è ovvio dal contesto.“Crea commessa”, non “Nuovo”
ColpaMai attribuita all'utente. Forma impersonale sul risultato.“Non è stato possibile salvare”, non “Hai inserito un valore errato”
LunghezzaUna frase per il titolo, una o due per il corpo. Se serve di più, serve una pagina di aiuto.—
Linguaggio tecnicoNessun codice di errore, nome di tabella o eccezione a schermo. Il riferimento tecnico solo come codice di supporto.“Codice assistenza: 4f2a”
PunteggiaturaPunto fermo nelle frasi. Niente punto in titoli, etichette, voci di menu e pulsanti. Mai punto esclamativo.“Commessa creata”
TerminiUn concetto, una parola, per tutto il prodotto. Se è “commessa” non diventa “lavoro” o “pratica” altrove.Glossario per prodotto
QuantitàIl numero è sempre esplicito, mai “alcuni” o “molti”. Singolare e plurale corretti.“1 commessa” · “14 commesse”
Date nei testiEstese nel testo corrente, numeriche nei dati e nelle tabelle.“Scade il 14 luglio” · tabella: 14/07/2026
AttesaIl pulsante che sta lavorando dice cosa sta facendo.“Salvataggio in corso”

4 · Tastiera e fuoco

Chi inserisce dati tutto il giorno non usa il mouse. In un gestionale la tastiera non è una questione di accessibilità soltanto: è velocità di lavoro.

Il fuoco si vede sempre

Anello di 3px nel colore co-primario, esterno all'elemento così non ne cambia la dimensione. Compare quando si naviga da tastiera e non al clic del mouse (:focus-visible).

NucleoL'anello di fuoco non si rimuove mai. outline: none senza una sostituzione visibile è il difetto di accessibilità più diffuso e rende l'applicativo inutilizzabile da tastiera. Se disturba, si cambia il suo aspetto — non lo si toglie.
TastoComportamento
TabScorre gli elementi nell'ordine visivo, non nell'ordine del codice. Nessun elemento interattivo viene saltato; nessun elemento non interattivo entra nel percorso.
InvioIn un campo di testo dentro un form: invia il form. Su un elemento a fuoco: lo attiva. In una riga di tabella selezionata: apre il dettaglio.
EscChiude dialogo, pannello laterale o menu aperto. Se ci sono modifiche non salvate, apre la conferma invece di chiudere.
SpazioSpunta la casella o seleziona la riga. Non fa scorrere la pagina quando il fuoco è su un elemento interattivo.
↑ ↓Scorrono le voci di un elenco a discesa o di un menu aperto, e le righe di una tabella con selezione attiva.
Ctrl+SSalva il form aperto, se il salvataggio è possibile. Sostituisce il salvataggio del browser.
/Porta il fuoco nella ricerca globale, quando il fuoco non è già in un campo di testo.
NucleoIl fuoco si sposta e torna. Quando si apre un dialogo, va sul primo campo — o sul titolo se non ci sono campi. Quando si chiude, torna all'elemento da cui era partito, così Tab riprende da dove si era. Dentro un dialogo aperto, Tab resta nel dialogo e non scorre la pagina sottostante.
NucleoNessuna funzione esiste solo al passaggio del puntatore. Se un'azione compare al passaggio del mouse, deve comparire anche quando la riga riceve il fuoco da tastiera. Vale per le azioni di riga, i menu contestuali e i suggerimenti che contengono informazioni.
NucleoDopo un'azione, il fuoco va dove l'utente continuerebbe. Eliminata una riga, va alla riga successiva. Aggiunta una riga a un elenco, va nel primo campo della nuova riga. Mai lasciato sul corpo della pagina, che costringe a ricominciare da Tab.

5 · Conferme e annullamento

Il criterio non è la gravità percepita ma una domanda sola: l'operazione è reversibile? Se sì, si esegue subito e si offre di annullare. Se no, si chiede conferma prima.

Reversibile → si esegue e si offre “Annulla”
✓ Commessa C-4817 eliminata

Cinque secondi. Nessun dialogo: l'utente non viene fermato per un'azione che può disfare. Il record si elimina davvero allo scadere, non prima.

Irreversibile → si chiede conferma, e si dice cosa sparisce
Elimina commessa C-4821
Verranno eliminate anche 14 lavorazioni e 3 documenti collegati. L'operazione non si può annullare.
Uscire senza salvare?
Le modifiche a Ristrutturazione sede non sono state salvate e andranno perse.
NucleoLa conferma quantifica le conseguenze. “Sei sicuro?” non aggiunge informazione: l'utente clicca sì senza leggere. “Verranno eliminate anche 14 lavorazioni” è l'unica cosa che può fermare un errore, perché dice qualcosa che l'utente non sapeva.
NucleoNon si chiede conferma per ciò che è reversibile. Una conferma su ogni azione insegna a cliccare senza leggere, e a quel punto anche la conferma che conta viene saltata. Le conferme sono poche perché devono restare efficaci.
NucleoL'uscita da un form con modifiche pendenti è sempre intercettata — dal pulsante Annulla, da Esc, dal cambio di pagina e dalla chiusura della scheda del browser. Senza modifiche, si chiude senza chiedere niente.
Quando fermare l'utente
AzioneComportamentoPerché
Elimina un record isolatoEsegue + “Annulla” 5sReversibile
Elimina un record con collegamentiConferma che li contaConseguenze non visibili
Elimina in massaConferma con il numeroAmpiezza non evidente
ArchiviaEsegue + “Annulla”Reversibile
Chiude un form modificatoConfermaPerdita di lavoro
Chiude un form intattoChiudeNiente da perdere
Invia a un sistema esternoConfermaNon ritirabile
Cambia stato con effetti a valleConferma che li elencaEffetti invisibili
Scarica, esporta, stampaEsegueNessuna conseguenza

6 · Salvataggio esplicito

Un solo modello in tutti i prodotti: finché non premi Salva, non è salvato. Nessuna schermata salva da sola. Il modello misto è escluso: se alcune schermate salvano e altre no, l'utente non sa mai se può chiudere.

I tre stati del piede di salvataggio
Nessuna modifica
Modifiche non salvate
Salvato alle 14:32
NucleoLo stato di salvataggio è sempre visibile. Il piede resta appiccicato in basso nei form lunghi, e dice in quale dei tre stati si trova. L'utente non deve dedurre se ha salvato.
NucleoSalva è disattivato quando non c'è niente da salvare — nessuna modifica, o modifiche non valide. Un pulsante attivo che poi rifiuta l'operazione è una promessa non mantenuta. Quando è disattivato per errori di validazione, il motivo è scritto accanto.
NucleoDurante il salvataggio il form resta leggibile. Il pulsante dice “Salvataggio in corso” ed è disattivato; i campi non si svuotano e la pagina non si oscura. Se il salvataggio fallisce, i dati restano nel form — sempre — e l'avviso lo dice esplicitamente.
NucleoIl salvataggio riuscito non ricarica la pagina né riporta all'elenco se non è quello che l'utente ha chiesto. Resta dove sta, con la notifica di conferma. “Salva e chiudi”, se serve, è un secondo pulsante dichiarato.

7 · Mantine 9 — corrispondenze

RegolaMantineNote
Avviso nella paginaAlertvariant="outline", radius={8}, withCloseButton solo se il messaggio è informativo. Mai variant="light": in v9 è un fondo pieno, non più una velatura, e resta escluso.
Notifica@mantine/notificationsposition="top-right", autoClose={4000}; errore in secondo piano autoClose={false}; con “Annulla” autoClose={5000}. limit={3} sul provider. In v9 il passaggio del mouse sospende il timer di tutte le notifiche visibili, non solo di quella sotto il puntatore: con tre notifiche in pila i tempi vanno riprovati.
Stato vuoto—Non esiste in Mantine: componente interno del gruppo con icon, title, description, action, e una variante per ciascuno dei quattro stati.
Sagome di caricamentoSkeletonNella forma del contenuto, con l'altezza delle righe vere. Loader solo dentro un pulsante che sta lavorando — o, sui campi, la prop loading introdotta in v9.
Confermamodals.openConfirmModallabels={{confirm:'Elimina definitivamente', cancel:'Annulla'}} — mai i predefiniti “Confirm/Cancel”. Distruttiva: confirmProps={{color:'danger'}}.
Fuoco nei dialoghiModalIl fuoco intrappolato e il ritorno sono predefiniti: non disattivare trapFocus né returnFocus.
Anello di fuocotheme.focusRingfocusRing: 'auto' (equivale a :focus-visible). Mai 'never'.
ScorciatoieuseHotkeys[['mod+S', save], ['/', focusSearch]]. Definite una volta nella cornice, non per pagina.
Modifiche pendentiform.isDirty()Guida lo stato del piede e l'intercettazione dell'uscita. Su beforeunload per la chiusura della scheda.
Validazione@mantine/formvalidateInputOnBlur sì, validateInputOnChange no. Lo schema passa da schemaResolver: in v9 Standard Schema è nativo (Zod v4, Valibot, ArkType) e i resolver dedicati non si installano più. La validazione asincrona è ora supportata: mentre un controllo lato server è in corso il campo mostra loading e il pulsante di salvataggio resta disattivato, senza messaggi di errore prematuri. I messaggi seguono le regole della sezione 3.
Salva disattivatoButtondisabled={!form.isDirty() || !form.isValid()}, loading durante il salvataggio.
Contenuto che si apreCollapseIn v9 la prop è expanded, non più in. Lo stato aperto/chiuso di un pannello si ricorda con useLocalStorage e un defaultValue esplicito.
Cosa resta.