14
Notifiche ed errori
Nucleo comuneNotifications & Errors
La domanda non è che colore ha un messaggio, è dove va. Nel posto sbagliato non viene letto.
Dove va un messaggio
| Situazione | Mezzo | Vive |
| Un'operazione è riuscita | Notifica in alto a destra | 4 secondi, poi sparisce da sola |
| Un'operazione è riuscita e si può annullare | Notifica con l'azione Annulla | 5 secondi. L'annullamento non è mai un secondo modale |
| Un'operazione è fallita mentre l'utente stava altrove | Notifica | Non si chiude da sola: va letta |
| Un'operazione è fallita e l'utente era lì | Avviso nel contesto — dentro la modale, sopra il form | Finché la causa non è risolta |
| Una condizione riguarda l'intera pagina | Avviso in pagina, sotto il titolo | Finché la condizione esiste |
| Un campo non è valido | Messaggio sotto il campo | Dall'uscita dal campo fino alla correzione |
| L'azione è distruttiva o irreversibile | Modale di conferma | Blocca, e dice cosa succede |
| Non ci sono dati da mostrare | Empty state al posto del contenuto | Finché non ci sono dati |
14.1L'errore che blocca sta dove l'utente lavorava, non in una notifica che sparisce. I dati restano nel form.nucleo
14.2Un messaggio che l'utente deve leggere non si chiude da solo.nucleo
14.3Il colore non è mai l'unico segno: ogni messaggio ha un titolo che dice cos'è successo.nucleo
La forma dell'avviso
Rettangolo bianco, bordo su quattro lati, raggio 10, nessuna ombra, e una icona di stato quadrata col colore dello stato.
I quattro toni
!3 certificati in scadenzaIl primo scade il 14/07/2026. Rinnovali per non bloccare le lavorazioni.Apri i certificati
×Il salvataggio non è andato a buon fineLa commessa C-4821 è stata modificata da un altro utente alle 09:12. I tuoi dati sono ancora in questa pagina: confronta le modifiche prima di salvare.ConfrontaRiprova
✓Rendiconto generatoIl file è disponibile fra i documenti della commessa.
iQuesta commessa è in sola letturaÈ stata chiusa il 30/04/2026. Per modificarla serve riaprirla, e l'operazione è tracciata.
Il tono cambia solo l'icona di stato. Fondo, bordo e raggio sono identici.
La notifica
In alto a destra, sopra il contenuto
✓Commessa creataC-4835 · Comune di Rho
Stessa forma dell'avviso, più --elev-overlay e il bordo.
| Regola | Valore |
| Posizione | In alto a destra, sotto la header. Una sola posizione in tutta l'applicazione |
| Durata | 4 secondi. Con azione di annullamento 5. Errore: nessuna scadenza |
| Quante insieme | Massimo tre. La quarta attende che una si chiuda |
| In hover | In Mantine 9 il timer si sospende per tutte le visibili, non solo per quella sotto il puntatore |
| Cosa non ci va | Testi lunghi, elenchi, moduli. Se non si legge in quattro secondi, non è una notifica |
I quattro empty state
“Vuoto” non è una situazione: sono quattro, e dicono cose diverse.
1 · Non c'è ancora niente
Nessuna commessa
Le commesse che crei compaiono qui, con stato e scadenza.
Crea la prima commessa
Porta l'azione che risolve.
2 · I filtri non trovano niente
Nessuna commessa con questi filtri
Tre filtri attivi: cliente “Rho”, stato “Bloccata”, scadenza in giugno.
Azzera i filtri
Dichiara quali filtri sono attivi e offre di azzerarli.
3 · Il caricamento è fallito
Non è stato possibile caricare le commesse
Il servizio non ha risposto. I dati non sono stati perduti.
Riprova
Dice che è un guasto, non un'assenza, e che nulla è perduto.
4 · Non hai il permesso
Non hai accesso a questa sezione
Serve il ruolo Responsabile commesse. Il tuo ruolo attuale è Operatore.
Chiedi l'abilitazione al tuo referente.
Dice quale permesso serve e a chi chiederlo.
14.4Ogni empty state dice tre cose: cos'è vuoto, perché, cosa si può fare.nucleo
14.5Lo empty state sta al posto del contenuto, non al centro dello schermo. Cornice e filtri restano dove sono.struttura
14.6L'attesa sotto 300ms non si annuncia.struttura
14.7Sopra 300ms, gli skeleton nella forma del contenuto e con l'altezza vera: la pagina non deve saltare quando i dati arrivano.struttura
Come si scrive un messaggio
No
“Errore 401”
“Operazione non consentita”
“Si è verificato un errore imprevisto”
“Campo obbligatorio”
“Sei sicuro?”
Dicono che qualcosa non va, non cosa fare.
Sì
“La sessione è scaduta. Accedi di nuovo per continuare.”
“Serve il ruolo Responsabile per chiudere una commessa.”
“Il servizio non ha risposto. Riprova; se continua, segnala il codice C-4821.”
“Indica la data di scadenza.”
“Elimini la commessa C-4821? Le tre lavorazioni collegate restano, senza commessa.”
Ognuno dice cos'è successo e cosa fare adesso.
14.8Nessun codice tecnico al posto del messaggio. Il codice dell'assistenza sta accanto, non al suo posto.nucleo
14.9La conferma dichiara le conseguenze, non chiede sicurezza. Il pulsante ripete il verbo: Elimina definitivamente, mai OK.nucleo
14.10Si chiede conferma solo per ciò che non si può annullare. Altrove si agisce e si offre Annulla nella notifica.nucleo
Nel tema Mantine
| Convenzione | Mantine 9 | Configurazione |
| Avviso in pagina | Alert | variant="outline", radius="md", withCloseButton solo se informativo. Mai variant="light": in v9 è un fondo pieno |
| Notifica | @mantine/notifications | position="top-right", autoClose={4000}, limit={3}; errore autoClose={false} |
| Conferma | modals.openConfirmModal | labels={{confirm:'Elimina definitivamente', cancel:'Annulla'}} — mai i predefiniti. Distruttiva: confirmProps={{color:'danger'}} |
| Empty state | — | Non esiste in Mantine: componente interno con icon, title, description, action e una variante per ciascuno dei quattro stati |
| Attesa | Skeleton | Nella forma del contenuto. Loader solo dentro un pulsante che sta lavorando; sui campi, la prop loading introdotta in v9 |