Campo immagine

Il campo image memorizza un singolo asset immagine gestito.

Ideale per

• immagini hero
• miniature delle card
• loghi
• foto degli autori
• visual delle sezioni

Esempio di schema

{ "name": "heroImage", "label": "Hero Image", "type": "image" }

Utilizzo nel template

<img src="{heroImage.webp}" alt="{heroImage.description}">

Utilizzo in stile hero:

{{#if heroImage}}
  <figure class="hero-media">
    <img src="{heroImage.width(1200).webp}" alt="{heroImage.description}">
  </figure>
{{/if}}

Quando usarlo

Usa image quando la sezione necessita di un singolo elemento visivo principale gestito.

Quando non usarlo

Non usare image quando:

• la sezione necessita di più elementi visivi
• l'asset dovrebbe essere scaricabile invece che mostrato

Usa invece images o file.

Note tecniche

• abbina i campi image a un campo di testo correlato quando la sezione necessita di una didascalia o di un'etichetta esplicita
• tratta l'immagine come un singolo asset primario, non come un modello di contenuto multi-elemento
• proteggi l'output dell'immagine opzionale con {{#if}} per evitare wrapper multimediali vuoti
• usa images o repeater se ogni elemento visivo necessita del proprio testo di supporto o metadati
• i campi per immagine singola supportano helper specifici del campo come {heroImage.raw}, {heroImage.webp}, {heroImage.width(N)}, e {heroImage.description}
• questa sintassi abbreviata è specifica del contratto del campo Component; gli oggetti immagine provenienti dal contesto di pagina o elenco solitamente utilizzano catene in stile oggetto di Facet che terminano con .url

Correlati

• Immagini
• File
• Ripetitore