← Torna alla documentazione

I tipi di campo e l’editor dei contenuti

Ogni campo di <TextField> dichiara un tipo. Il tipo decide quale widget di modifica mostra il pannello e, sul sito, quali variabili aggiuntive lo accompagnano.

Il testo è il più semplice: un campo su una riga, stampato così com’è. Markdown offre un’area di testo completa basata su CodeMirror, con una piccola barra degli strumenti per i titoli, un’anteprima dal vivo e un pulsante «inserisci immagine». Vengono salvati sia il sorgente markdown sia l’HTML generato: il sorgente per poterlo modificare in seguito, l’HTML perché il sito non debba mai analizzare markdown durante una richiesta. Editor funziona allo stesso modo ma con Trix, per chi preferisce scrivere in un riquadro di testo formattato piuttosto che in markdown.

I campi immagine e file gestiscono i caricamenti. Scegli un file e il pannello lo sposta in uploads/, controlla che sia davvero un’immagine quando il tipo lo richiede e può creare una miniatura ridimensionata se hai impostato una larghezza o un’altezza sul campo. Tag salva un elenco separato da virgole e sul sito lo trasforma in un array di voci {name: ...}, il che rende facile una fila di etichette o una raccolta filtrata per tag. Gli altri tipi sono colore, data e ora, link, email, html e booleano. Ognuno ha la sua validazione e il suo widget, e ognuno è salvato in un unico campo JSON.

Niente di tutto questo è scritto nel codice dei tuoi template. Aggiungi dal pannello un campo di qualsiasi tipo a una voce statica o a un elemento di una raccolta, e la variabile {key} corrispondente è lì alla prossima visualizzazione della pagina.