12
Form
Nucleo comuneForms
Un form in un gestionale non è un modulo di contatto: è dove si registrano dati che valgono soldi. La regola che governa tutto è che il lavoro non si perde; il resto sono conseguenze.
Anatomia del campo
Ragione sociale*Comune di Rho
Codice commessa*Assegnato alla conferma se lasciato vuoto.C-0000
ReferentefacoltativoMarco Bianchi
Data di scadenza*30/02/2026Il 30 febbraio non esiste. Indica una data valida.
Valore di commessa128.450,00 €Calcolato dalle righe di dettaglio.
Etichetta sopra il campo, in 600. Aiuto sotto l'etichetta, prima del campo. Errore sotto il campo, in rosso, con la sua icona.
| Parte | Misura | Nota |
| Etichetta | 14px / 600 | Sempre sopra il campo, mai a sinistra e mai dentro |
| Testo di aiuto | 13px | Fra etichetta e campo: si legge prima di scrivere, non dopo |
| Campo | 36px · 15px · raggio 6 | Bordo --line-strong: è un'affordance, non decorazione |
| Errore | 13,5px | Sotto il campo, con icona. Sostituisce l'aiuto, non lo affianca |
| Spazio fra campi | 14px verticale · 16px orizzontale | Fra gruppi, 24px più un filetto |
| Larghezza | max 520px in colonna singola | Un campo lungo quanto lo schermo non dice quanto testo ci va |
12.1L'etichetta sta sopra il campo e non sparisce mai. Nessun placeholder al posto dell'etichetta, nessuna etichetta flottante.nucleo
12.2Il placeholder mostra il formato atteso — C-0000, gg/mm/aaaa — o non c'è. Non ripete l'etichetta.struttura
12.3Predefinito: asterisco sugli obbligatori. Se in un prodotto quasi tutto è obbligatorio si passa a facoltativo sugli altri, ma è una scelta di prodotto: si dichiara all'avvio in DICHIARAZIONE.md, non per schermata.struttura
12.4La larghezza del campo suggerisce la lunghezza del dato. Un CAP non è largo come una ragione sociale.struttura
12.5Un campo calcolato non è un campo disattivato: è in sola lettura e dice da dove viene il valore.nucleo
12.6Il campo in sola lettura perde il bordo e diventa testo in 500. Un bordo dice “qui si scrive”, e mentirebbe.struttura
Disposizione
Anagrafica
Chi è il committente e chi segue la commessa.
Ragione sociale*Comune di Rho
Partita IVA*03654280158
ReferenteMarco Bianchi
Telefono+39
IndirizzoPiazza San Vittore 24, 20017 Rho MI
Tempi e valore
Inizio lavori*14/06/2026
Scadenza*28/06/2026
Valore stimato128.450,00 €
Centro di costoMilano — Impianti
Modifiche non salvateAnnullaSalva
Gruppi con titolo, due colonne dove i campi sono brevi, una colonna intera dove il dato è lungo. Footer di salvataggio sticky, nei tre stati della sezione 7.
12.7Una colonna per difetto, due quando i campi sono brevi e correlati. Mai tre.struttura
12.8Si legge in verticale: con due colonne l'ordine è sinistra-destra, poi riga successiva. Un campo che occupa tutta la larghezza chiude il gruppo.struttura
12.9I gruppi hanno un titolo e non sono richiudibili. Un form non è un accordion: nascondere campi obbligatori li fa dimenticare.struttura
12.10Oltre i venticinque campi si passa a step o a tab, non a una pagina che scorre per tre schermate.struttura
12.11L'ordine dei campi è quello in cui l'utente ha i dati, non quello delle colonne del database.nucleo
12.12Azione primaria a destra nel footer, secondaria alla sua sinistra, distruttiva staccata all'estremo opposto.struttura
Validazione
| Quando | Cosa succede |
| Mentre si scrive | Niente. Solo i vincoli di forma che impediscono l'input sbagliato: lunghezza massima, solo cifre |
| All'uscita dal campo | Validazione del singolo campo. È il momento in cui compare l'errore |
| Al salvataggio | Validazione di tutto, comprese le regole fra campi. Il fuoco va sul primo campo non valido |
| Dal server | L'errore torna sul campo che lo ha causato; se riguarda l'operazione, va in un alert sopra il form |
No
“Campo obbligatorio”
“Valore non valido”
“Formato errato”
“Errore di validazione”
Sì
“Indica la data di scadenza.”
“La partita IVA ha 11 cifre.”
“La scadenza deve seguire l'inizio lavori.”
“Questo codice è già usato dalla commessa C-4817.”
12.13Si valida all'uscita dal campo, non a ogni tasto. Un errore che compare mentre si sta ancora scrivendo dice che si sbaglia prima di aver finito.nucleo
12.14L'errore dice cosa fare, non che c'è un errore. Frase intera, con il dato atteso.nucleo
12.15L'errore corretto sparisce subito, senza aspettare un altro salvataggio.struttura
12.16Il colore non è mai l'unico segno dell'errore: bordo rosso più icona più testo.nucleo
12.17Al salvataggio fallito il fuoco va sul primo campo non valido, e se serve la pagina scorre fino a lui.nucleo
12.18Le regole fra campi si mostrano sul campo che l'utente può correggere, non su entrambi.struttura
Quale campo per quale dato
| Dato | Componente | Nota |
| Testo breve | TextInput | — |
| Testo lungo | Textarea | autosize con minRows: non una barra di scorrimento dentro tre righe |
| Numero, importo | NumberInput | Separatore migliaia, due decimali, unità come rightSection |
| Data | DatePickerInput | valueFormat="DD/MM/YYYY", locale="it", lunedì in prima colonna. Sempre digitabile oltre che selezionabile |
| Fino a 5 opzioni | Radio.Group | Tutte visibili: una tendina che nasconde tre voci costa un clic per niente |
| Oltre 5 opzioni | Select | searchable oltre le dieci |
| Più scelte | MultiSelect | Oltre 3 selezionate, le eccedenti si raccolgono in “+N” |
| Elenco dal server | Autocomplete | Prop loading (nuova in v9) durante l'interrogazione |
| Sì / no | Checkbox o Switch | Checkbox se ha effetto al salvataggio, Switch se ha effetto subito. Non si usano a caso |
| File | Dropzone | Con l'elenco dei caricati e il tipo ammesso scritto, non solo validato |
Nell'implementazione
| Convenzione | Dove | Configurazione |
| Form | @mantine/form | validateInputOnBlur: true, validateInputOnChange: false |
| Schema | zod + mantine-form-zod-resolver | Come prescrive lo stack. I messaggi stanno nello schema, non nel componente, e passano da i18next |
| Etichetta e aiuto | Input.Wrapper | label, description, error, withAsterisk. Non si compongono a mano |
| Stato sporco | form.isDirty() | Guida il footer, il blocco dell'uscita e beforeunload |
| Salva | Button | disabled={!form.isDirty()}, loading durante l'invio |
| Errore dal server | form.setFieldError | Dal codice 422 UPPER_SNAKE_CASE del contratto al campo, con una mappa dichiarata |
| Footer sticky | — | Componente condiviso in shared/design/: tre stati, non riscritto per pagina |
Da fareManca lo step multi-pagina (12.10): indicatore di avanzamento, validazione per passo, cosa succede tornando indietro. Da scrivere quando arriva una schermata vera che lo usi.