Campo `images`
Campo images
El images field almacena una colección de activos de imagen gestionados.
Ideal para
- galerías
- nubes de logotipos
- secciones con varias imágenes
- controles deslizantes o entradas de carrusel
Ejemplo de esquema
{ "name": "gallery", "label": "Gallery", "type": "images" }Uso en plantilla
<div class="gallery">
{{#each gallery}}
<img src="{{this.width(800).webp}}" alt="{{this.description}}">
{{/each}}
</div>Con salida basada en el bucle:
<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>Úsalo cuando
Usa images cuando una sección necesite varios elementos visuales relacionados gestionados como un conjunto.
No lo uses cuando
No uses images para:
- un visual principal
- archivos descargables
- tarjetas repetibles estructuradas donde cada fila necesita más que solo una imagen
Usa image, file o repeater en su lugar.
Notas técnicas
- usa
{{#each}}para todo el renderizado de múltiples imágenes - mantén el campo para colecciones de imágenes, no para estructuras de filas mixtas de imagen más texto
- si cada elemento de la galería necesita su propio título, CTA o bloque de descripción, pásate a
repeater - revisa el volumen de salida para que un componente no sea responsable de un conjunto de medios demasiado grande
- dentro de
{{#each gallery}}, los elementos de imagen exponen helpers como{{this.raw}},{{this.webp}},{{this.width(N)}}y{{this.description}} - esta forma de helpers orientada al bucle es específica de los campos
imagesde Componente; los objetos de imagen de página o lista normalmente continúan la cadena con.url