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.
ParteMisuraNota
Etichetta14px / 600Sempre sopra il campo, mai a sinistra e mai dentro
Testo di aiuto13pxFra etichetta e campo: si legge prima di scrivere, non dopo
Campo36px · 15px · raggio 6Bordo --line-strong: è un'affordance, non decorazione
Errore13,5pxSotto il campo, con icona. Sostituisce l'aiuto, non lo affianca
Spazio fra campi14px verticale · 16px orizzontaleFra gruppi, 24px più un filetto
Larghezzamax 520px in colonna singolaUn 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

QuandoCosa succede
Mentre si scriveNiente. Solo i vincoli di forma che impediscono l'input sbagliato: lunghezza massima, solo cifre
All'uscita dal campoValidazione del singolo campo. È il momento in cui compare l'errore
Al salvataggioValidazione di tutto, comprese le regole fra campi. Il fuoco va sul primo campo non valido
Dal serverL'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

DatoComponenteNota
Testo breveTextInput—
Testo lungoTextareaautosize con minRows: non una barra di scorrimento dentro tre righe
Numero, importoNumberInputSeparatore migliaia, due decimali, unità come rightSection
DataDatePickerInputvalueFormat="DD/MM/YYYY", locale="it", lunedì in prima colonna. Sempre digitabile oltre che selezionabile
Fino a 5 opzioniRadio.GroupTutte visibili: una tendina che nasconde tre voci costa un clic per niente
Oltre 5 opzioniSelectsearchable oltre le dieci
Più scelteMultiSelectOltre 3 selezionate, le eccedenti si raccolgono in “+N”
Elenco dal serverAutocompleteProp loading (nuova in v9) durante l'interrogazione
Sì / noCheckbox o SwitchCheckbox se ha effetto al salvataggio, Switch se ha effetto subito. Non si usano a caso
FileDropzoneCon l'elenco dei caricati e il tipo ammesso scritto, non solo validato

Nell'implementazione

ConvenzioneDoveConfigurazione
Form@mantine/formvalidateInputOnBlur: true, validateInputOnChange: false
Schemazod + mantine-form-zod-resolverCome prescrive lo stack. I messaggi stanno nello schema, non nel componente, e passano da i18next
Etichetta e aiutoInput.Wrapperlabel, description, error, withAsterisk. Non si compongono a mano
Stato sporcoform.isDirty()Guida il footer, il blocco dell'uscita e beforeunload
SalvaButtondisabled={!form.isDirty()}, loading durante l'invio
Errore dal serverform.setFieldErrorDal 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
RimandoSalvataggio, uscita con modifiche pendenti, permessi e sola lettura stanno in 7 · Principi di interazione; dove va un messaggio di errore in 14 · Notifiche ed errori.
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.