Campo `images`
Campo images
Il campo images memorizza una collezione di asset immagine gestiti.
Ideale per
- gallerie
- cloud di loghi
- sezioni con più immagini
- input per slider o carosello
Esempio di schema
{ "name": "gallery", "label": "Gallery", "type": "images" }Uso nel template
<div class="gallery">
{{#each gallery}}
<img src="{{this.width(800).webp}}" alt="{{this.description}}">
{{/each}}
</div>Con output consapevole del ciclo:
<div class="gallery-grid">
{{#each gallery}}
<figure class="{{#if loop.first}}gallery-item-featured{{else}}gallery-item{{/if}}">
<img src="{{this.width(1200).webp}}" alt="{{this.description}}">
</figure>
{{/each}}
</div>Quando usarlo
Usa images quando una sezione ha bisogno di diverse immagini correlate gestite come un insieme.
Quando non usarlo
Non usare images per:
- una sola immagine principale
- file scaricabili
- schede ripetibili strutturate dove ogni riga necessita di più di una sola immagine
Usa image, file o repeater invece.
Note tecniche
- usa
{{#each}}per tutto il rendering multi-immagine - mantieni il campo per collezioni di immagini, non per strutture di riga miste immagine+testo
- se ogni elemento della galleria necessita del proprio titolo, CTA o blocco descrizione, passa a
repeater - rivedi il volume dell'output in modo che un singolo componente non sia responsabile di un set multimediale eccessivo
- dentro
{{#each gallery}}, gli elementi immagine espongono helper come{{this.raw}},{{this.webp}},{{this.width(N)}}e{{this.description}} - questa forma helper orientata al ciclo è specifica per i campi Component
images; gli oggetti immagine di pagina o lista di solito continuano la catena con.url