7
Principi di interazione
Nucleo comuneUX Principles
Quasi tutta nucleo: non si deroga per nessun committente. Riguarda cosa succede quando le cose non vanno come previsto.
I cinque principi
7.1Il sistema dice sempre in che stato è. Caricamento, salvataggio, modifiche non salvate, sola lettura, filtro attivo: si dichiarano, non si deducono.nucleo
7.2Nessuna azione avviene senza che l'utente l'abbia chiesta.nucleo
7.3Ogni azione distruttiva è annullabile o confermata. Una delle due, sempre. Mai nessuna delle due.nucleo
7.4Il lavoro dell'utente non si perde mai. Salvataggio fallito: i dati restano. Sessione scaduta: si torna dove si era.nucleo
7.5Tutto si fa da tastiera, e il fuoco è sempre visibile.nucleo
Il salvataggio è esplicito
Qui si registrano dati che valgono soldi e responsabilità: si salva quando l'utente lo chiede, e lo stato è sempre visibile.
I tre stati del footer
Nei form lunghi il footer resta sticky in basso con --elev-raised.
7.6Salva è disattivato quando non c'è niente da salvare — nessuna modifica, o modifiche non valide.nucleo
7.7Un comando disattivato dice perché. Mai grigio e muto.nucleo
7.8Durante il salvataggio il form resta leggibile: i campi non si svuotano, la pagina non si oscura.nucleo
7.9Il salvataggio riuscito non ricarica né riporta all'elenco. Salva e chiudi, se serve, è un secondo pulsante.nucleo
7.10Uscire con modifiche pendenti chiede conferma, e la conferma dice cosa si perde.nucleo
7.11La validazione avviene all'uscita dal campo, non a ogni tasto.struttura
Tastiera e fuoco
Fuoco e selezione si distinguono per forma, non per colore
A riposo
Fuoco — focus ring di 3px
Selezionato — filetto pieno di 2px
Il fuoco è celeste in entrambe le palette — è la posizione della tastiera, non uno stato del dato. La selezione segue la dominante.
| Tasto | Cosa fa | Dove |
| Tab | Sposta il fuoco nell'ordine visivo, non nell'ordine del DOM se divergono | Ovunque |
| Invio | Conferma l'azione primaria del contesto | Form, modale |
| Esc | Chiude senza salvare. Sempre, e senza chiedere se non ci sono modifiche | Modale, pannello, foglio, dropdown |
| ↑ ↓ | Naviga fra le voci di un dropdown e fra le righe di una griglia selezionabile | Discesa, griglia |
| Ctrl S | Salva, dove esiste un salvataggio | Definito una volta nella shell |
| / | Porta il fuoco nella ricerca | Definito una volta nella shell |
7.12Il fuoco è sempre visibile: :focus-visible non si rimuove.nucleo
7.13In una modale il fuoco resta dentro e torna dove era. In Mantine sono predefiniti: non si disattivano.nucleo
7.14All'apertura il fuoco va sul primo campo modificabile. In una modale distruttiva, su Annulla.struttura
7.15Le scorciatoie si definiscono una volta nella shell, uguali in tutti i prodotti.struttura
Attese
No
Un cerchio che gira al centro dello schermo.
Un indicatore che appare e sparisce in 200ms.
La pagina che salta quando i dati arrivano.
La schermata che si oscura mentre si salva.
Sì
Sotto 300ms: niente.
Sopra 300ms: skeleton nella forma del contenuto atteso, con l'altezza delle righe vere.
Dentro un pulsante che sta lavorando: l'indicatore nel pulsante.
Su un campo che interroga il server: la prop loading del campo.
Scrittura
7.16Italiano professionale e chiaro. Frasi brevi, verbi attivi. Niente emoji.nucleo
7.17Un concetto, una parola. Il glossario è per prodotto, e lo compila chi conosce il dominio.nucleo
7.18L'etichetta dice cosa fa il comando: “Nuova commessa”, non “Crea una nuova commessa”.nucleo
7.19Ogni messaggio dice cos'è successo e cosa fare adesso (14).nucleo
Permessi e sola lettura
Cosa vede chi non può agire dipende dal perché non può.
| Situazione | Cosa si vede | Perché |
| L'utente non potrà mai — il ruolo non lo prevede | L'azione non compare | Mostrare comandi che non si otterranno mai è rumore permanente |
| L'utente potrebbe, ma non adesso — stato del dato, blocco, fase | L'azione è disattivata col motivo scritto | Il motivo è informazione sul dato: “la commessa è chiusa” dice più di un comando assente |
| L'intera schermata è in sola lettura | Avviso informativo in cima, campi non modificabili, azioni di modifica assenti | Dichiarato una volta invece di venti campi disattivati senza spiegazione |
| L'utente non ha accesso alla sezione | Empty state che dice quale ruolo serve e a chi chiederlo | “Accesso negato” non dice cosa fare |
Da confermareSe i ruoli sono dinamici — un utente può chiedere un'abilitazione — la prima riga cambia: nascondere un'azione ottenibile impedisce di scoprire che esiste.
Nel tema Mantine
| Regola | Mantine 9 | Configurazione |
| Focus ring | theme.focusRing | 'auto', che equivale a :focus-visible. Mai 'never' |
| Fuoco nei modali | Modal | Non disattivare trapFocus né returnFocus |
| Scorciatoie | useHotkeys | [['mod+S', save], ['/', focusSearch]], nella shell |
| Modifiche pendenti | form.isDirty() | Guida il footer e l'intercettazione dell'uscita; su beforeunload per la chiusura della scheda |
| Validazione | @mantine/form | validateInputOnBlur sì, validateInputOnChange no. Lo schema passa da mantine-form-zod-resolver con Zod, come prescrive lo stack aziendale. Mantine 9 accetta anche Standard Schema nativo, ma il resolver è la via dichiarata |
| Salva disattivato | Button | disabled={!form.isDirty() || !form.isValid()}, loading durante il salvataggio |
| Movimento | theme | Sempre nel rispetto di prefers-reduced-motion |