Image-Feld

Das image-Feld speichert ein verwaltetes Bild-Asset.

Am besten für

• Hero-Bilder
• Karten-Vorschaubilder
• Logos
• Autorenfotos
• Visuelle Elemente für Abschnitte

Schema-Beispiel

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

Template-Verwendung

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

Verwendung im Hero-Stil:

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

Wann verwenden

Verwenden Sie image, wenn der Abschnitt ein einzelnes, primäres verwaltetes Bild benötigt.

Nicht verwenden, wenn

Verwenden Sie image nicht, wenn:

• der Abschnitt mehrere visuelle Elemente benötigt
• das Asset herunterladbar statt angezeigt werden soll

Verwenden Sie stattdessen images oder file.

Technische Hinweise

• Kombinieren Sie image-Felder mit einem zugehörigen Textfeld, wenn der Abschnitt eine explizite Bildunterschrift oder ein Label benötigt
• Behandeln Sie das Bild als primäres Asset, nicht als Content-Modell mit mehreren Elementen
• Sichern Sie optionale Bildausgaben mit {{#if}} ab, um leere Media-Wrapper zu vermeiden
• Verwenden Sie images oder repeater, wenn jedes visuelle Element einen eigenen Begleittext oder Metadaten benötigt
• Einzelbildfelder unterstützen feldspezifische Helfer wie {heroImage.raw}, {heroImage.webp}, {heroImage.width(N)} und {heroImage.description}
• Diese Kurzschreibweise ist spezifisch für den Component-Feldvertrag; Bildobjekte, die aus Seiten- oder Listenkontext stammen, verwenden in der Regel objektartige Facet-Ketten, die in .url enden

Verwandte

• Images
• File
• Repeater