Guida · Il contenuto
I form
Il form è un documento a parte, e il blocco lo cita. Due entità, e il motivo è che lo stesso form serve in tre pagine.
Dove siamo
Sai leggere dal database e disegnare elenchi. Alla fine di questo capitolo avrai un form che raccoglie dati, e saprai perché non vive dentro la pagina che lo mostra.
Il gesto
Vai nella collection forms e creane uno. Dagli un titolo. Nel contenuto metti i campi.
Anche i messaggi sono campi del form: confirmationMessage è ciò che appare a invio riuscito, errorMessage ciò che appare quando l’invio fallisce senza un campo colpevole — arrivano già compilati in inglese, e li riscrivi lì (sono localizzati). Gli errori dei singoli campi invece non si scrivono: li dicono i controlli, ognuno il suo.
Torna sulla pagina. Aggiungi un blocco form e nel campo formRef scegli quello che hai appena creato.
Salva, ricarica, compila. Le risposte finiscono in form-submissions.
// un blocco dentro layout di una pagina, in Payload
{
"blockType": "form",
"viewMode": "Form",
"formRef": "<id del documento in forms>"
}Cos’è appena successo
Il blocco non contiene il form: contiene un riferimento. È la stessa scelta del viewMode citato per nome, applicata a un documento — e compra la stessa cosa, cioè un punto solo da cambiare.
Un form in tre pagine è un documento e tre riferimenti. Correggere l’etichetta di un campo è un’operazione sola, e le tre pagine non se ne accorgono perché non l’hanno mai contenuta.
Quando non funziona
Cancella il documento a cui un blocco form punta. La pagina non si rompe: il riferimento resta e non risolve più, quindi il form semplicemente non compare.
Vale per tutti i riferimenti, non solo per i form: puntare a qualcosa che non c’è è silenzioso di suo.
Avanti
Hai le pagine. Nel capitolo dopo, quello che sta intorno a tutte: header, footer e impostazioni.