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
Nessuna modificaAnnullaSalva
Modifiche non salvateAnnullaSalva
Salvataggio in corso…AnnullaSalvataggio…
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.
TastoCosa faDove
TabSposta il fuoco nell'ordine visivo, non nell'ordine del DOM se divergonoOvunque
InvioConferma l'azione primaria del contestoForm, modale
EscChiude senza salvare. Sempre, e senza chiedere se non ci sono modificheModale, pannello, foglio, dropdown
↑ ↓Naviga fra le voci di un dropdown e fra le righe di una griglia selezionabileDiscesa, griglia
Ctrl SSalva, dove esiste un salvataggioDefinito una volta nella shell
/Porta il fuoco nella ricercaDefinito 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ò.

SituazioneCosa si vedePerché
L'utente non potrà mai — il ruolo non lo prevedeL'azione non compareMostrare comandi che non si otterranno mai è rumore permanente
L'utente potrebbe, ma non adesso — stato del dato, blocco, faseL'azione è disattivata col motivo scrittoIl motivo è informazione sul dato: “la commessa è chiusa” dice più di un comando assente
L'intera schermata è in sola letturaAvviso informativo in cima, campi non modificabili, azioni di modifica assentiDichiarato una volta invece di venti campi disattivati senza spiegazione
L'utente non ha accesso alla sezioneEmpty 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

RegolaMantine 9Configurazione
Focus ringtheme.focusRing'auto', che equivale a :focus-visible. Mai 'never'
Fuoco nei modaliModalNon disattivare trapFocus né returnFocus
ScorciatoieuseHotkeys[['mod+S', save], ['/', focusSearch]], nella shell
Modifiche pendentiform.isDirty()Guida il footer e l'intercettazione dell'uscita; su beforeunload per la chiusura della scheda
Validazione@mantine/formvalidateInputOnBlur 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 disattivatoButtondisabled={!form.isDirty() || !form.isValid()}, loading durante il salvataggio
MovimentothemeSempre nel rispetto di prefers-reduced-motion
Il perchéComportamento.