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

SituazioneMezzoVive
Un'operazione è riuscitaNotifica in alto a destra4 secondi, poi sparisce da sola
Un'operazione è riuscita e si può annullareNotifica con l'azione Annulla5 secondi. L'annullamento non è mai un secondo modale
Un'operazione è fallita mentre l'utente stava altroveNotificaNon si chiude da sola: va letta
Un'operazione è fallita e l'utente era lìAvviso nel contesto — dentro la modale, sopra il formFinché la causa non è risolta
Una condizione riguarda l'intera paginaAvviso in pagina, sotto il titoloFinché la condizione esiste
Un campo non è validoMessaggio sotto il campoDall'uscita dal campo fino alla correzione
L'azione è distruttiva o irreversibileModale di confermaBlocca, e dice cosa succede
Non ci sono dati da mostrareEmpty state al posto del contenutoFinché 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.
RegolaValore
PosizioneIn alto a destra, sotto la header. Una sola posizione in tutta l'applicazione
Durata4 secondi. Con azione di annullamento 5. Errore: nessuna scadenza
Quante insiemeMassimo tre. La quarta attende che una si chiuda
In hoverIn Mantine 9 il timer si sospende per tutte le visibili, non solo per quella sotto il puntatore
Cosa non ci vaTesti 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

ConvenzioneMantine 9Configurazione
Avviso in paginaAlertvariant="outline", radius="md", withCloseButton solo se informativo. Mai variant="light": in v9 è un fondo pieno
Notifica@mantine/notificationsposition="top-right", autoClose={4000}, limit={3}; errore autoClose={false}
Confermamodals.openConfirmModallabels={{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
AttesaSkeletonNella forma del contenuto. Loader solo dentro un pulsante che sta lavorando; sui campi, la prop loading introdotta in v9
Il perchéNotifiche e banner per le forme scartate, Comportamento per empty state e riscritture.