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.
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.
| Codice | Cliente | Stato |
|---|
| Codice | Cliente | Stato |
|---|
| Codice | Cliente | Stato |
|---|
| Codice | Cliente | Stato |
|---|
— in grigio medio. Mai cella vuota, mai "N/D", mai zero al posto del nulla: 0,00 € e "nessun importo" sono fatti diversi.Due componenti diversi che vengono spesso scambiati. La distinzione è una sola domanda: l'utente può perdersi questo messaggio?
| Situazione | Componente | Durata | Colore |
|---|---|---|---|
| Salvataggio riuscito | Notifica | 4 secondi | success |
| Salvataggio fallito | Avviso sopra il form | fino alla correzione | danger |
| Errori di validazione | Sotto ogni campo | fino alla correzione | danger |
| Record in scadenza o incompleto | Avviso in cima al contenuto | finché la condizione dura | warning |
| Record in sola lettura o archiviato | Avviso in cima al contenuto | permanente | info |
| Operazione lunga avviata | Notifica | 4 secondi | info |
| Operazione in secondo piano fallita | Notifica | manuale | danger |
| Elemento eliminato | Notifica con “Annulla” | 5 secondi | neutro |
| Sessione in scadenza | Dialogo | fino alla risposta | warning |
La regola sotto tutte le altre: il testo dice cosa fare, non cosa è andato storto. Chi legge deve poter agire senza interpretare.
| Aspetto | Regola | Esempio |
|---|---|---|
| Persona | Si dà del tu, in tono professionale e asciutto. Mai il “lei”, mai il “noi” aziendale. | “Rinnovalo per non bloccare le lavorazioni” |
| Pulsanti | Verbo all'infinito + oggetto, se l'oggetto non è ovvio dal contesto. | “Crea commessa”, non “Nuovo” |
| Colpa | Mai attribuita all'utente. Forma impersonale sul risultato. | “Non è stato possibile salvare”, non “Hai inserito un valore errato” |
| Lunghezza | Una frase per il titolo, una o due per il corpo. Se serve di più, serve una pagina di aiuto. | — |
| Linguaggio tecnico | Nessun codice di errore, nome di tabella o eccezione a schermo. Il riferimento tecnico solo come codice di supporto. | “Codice assistenza: 4f2a” |
| Punteggiatura | Punto fermo nelle frasi. Niente punto in titoli, etichette, voci di menu e pulsanti. Mai punto esclamativo. | “Commessa creata” |
| Termini | Un 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 testi | Estese nel testo corrente, numeriche nei dati e nelle tabelle. | “Scade il 14 luglio” · tabella: 14/07/2026 |
| Attesa | Il pulsante che sta lavorando dice cosa sta facendo. | “Salvataggio in corso” |
Chi inserisce dati tutto il giorno non usa il mouse. In un gestionale la tastiera non è una questione di accessibilità soltanto: è velocità di lavoro.
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).
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.| Tasto | Comportamento |
|---|---|
| Tab | Scorre gli elementi nell'ordine visivo, non nell'ordine del codice. Nessun elemento interattivo viene saltato; nessun elemento non interattivo entra nel percorso. |
| Invio | In 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. |
| Esc | Chiude dialogo, pannello laterale o menu aperto. Se ci sono modifiche non salvate, apre la conferma invece di chiudere. |
| Spazio | Spunta 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+S | Salva 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. |
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.
Cinque secondi. Nessun dialogo: l'utente non viene fermato per un'azione che può disfare. Il record si elimina davvero allo scadere, non prima.
| Azione | Comportamento | Perché |
|---|---|---|
| Elimina un record isolato | Esegue + “Annulla” 5s | Reversibile |
| Elimina un record con collegamenti | Conferma che li conta | Conseguenze non visibili |
| Elimina in massa | Conferma con il numero | Ampiezza non evidente |
| Archivia | Esegue + “Annulla” | Reversibile |
| Chiude un form modificato | Conferma | Perdita di lavoro |
| Chiude un form intatto | Chiude | Niente da perdere |
| Invia a un sistema esterno | Conferma | Non ritirabile |
| Cambia stato con effetti a valle | Conferma che li elenca | Effetti invisibili |
| Scarica, esporta, stampa | Esegue | Nessuna conseguenza |
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.
| Regola | Mantine | Note |
|---|---|---|
| Avviso nella pagina | Alert | variant="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/notifications | position="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 caricamento | Skeleton | Nella 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. |
| Conferma | modals.openConfirmModal | labels={{confirm:'Elimina definitivamente', cancel:'Annulla'}} — mai i predefiniti “Confirm/Cancel”. Distruttiva: confirmProps={{color:'danger'}}. |
| Fuoco nei dialoghi | Modal | Il fuoco intrappolato e il ritorno sono predefiniti: non disattivare trapFocus né returnFocus. |
| Anello di fuoco | theme.focusRing | focusRing: 'auto' (equivale a :focus-visible). Mai 'never'. |
| Scorciatoie | useHotkeys | [['mod+S', save], ['/', focusSearch]]. Definite una volta nella cornice, non per pagina. |
| Modifiche pendenti | form.isDirty() | Guida lo stato del piede e l'intercettazione dell'uscita. Su beforeunload per la chiusura della scheda. |
| Validazione | @mantine/form | validateInputOnBlur 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 disattivato | Button | disabled={!form.isDirty() || !form.isValid()}, loading durante il salvataggio. |
| Contenuto che si apre | Collapse | In v9 la prop è expanded, non più in. Lo stato aperto/chiuso di un pannello si ricorda con useLocalStorage e un defaultValue esplicito. |