Campo image

El campo image almacena un activo de imagen administrado.

Ideal para

• imágenes principales
• miniaturas de tarjetas
• logotipos
• fotos de autor
• elementos visuales de sección

Ejemplo de esquema

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

Uso en plantillas

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

Uso estilo hero:

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

Úsalo cuando

Usa image cuando la sección necesite un único elemento visual principal administrado.

No lo uses cuando

No uses image cuando:

• la sección necesite varios elementos visuales
• el activo deba poder descargarse en lugar de mostrarse

Usa images o file en su lugar.

Notas técnicas

• combina los campos de imagen con un campo de texto relacionado cuando la sección necesite un pie de foto o etiqueta explícita
• trata la imagen como un único activo principal, no como un modelo de contenido con varios elementos
• protege la salida opcional de la imagen con {{#if}} para evitar contenedores de medios vacíos
• usa images o repeater si cada elemento visual necesita su propio texto de apoyo o metadatos
• los campos de imagen única soportan helpers específicos de campo tales como {heroImage.raw}, {heroImage.webp}, {heroImage.width(N)}, y {heroImage.description}
• esta abreviatura es específica del contrato del campo Component; los objetos image procedentes del contexto de página o lista suelen usar cadenas de Facet en estilo objeto que terminan en .url

Relacionado

• Imágenes
• Archivo
• Repetidor