Download-Komponente download-component

Die Kernkomponente „Download-Komponente“ ermöglicht die Erstellung einer Download-Option auf einer Seite.

Nutzung usage

Die Kernkomponente „Download-Komponente“ ermöglicht die Erstellung einer Download-Option und zugehöriger Elemente auf einer Seite.

Version und Kompatibilität version-and-compatibility

Die aktuelle Version der Download-Komponente ist v2, die mit Version 2.18.0 der Kernkomponenten im Februar 2022 eingeführt wurde und in diesem Dokument beschrieben wird.

Die folgende Tabelle enthält alle unterstützten Versionen der Komponente, die AEM-Versionen, mit denen die Versionen der Komponente kompatibel sind, sowie Links zur Dokumentation für frühere Versionen.

Komponentenversion
AEM 6.4
AEM 6.5
AEM as a Cloud Service
v2
-
Kompatibel
Kompatibel
v1
Kompatibel
Kompatibel
Kompatibel

Weitere Informationen zu Kernkomponentenversionen und -freigaben finden Sie im Dokument Kernkomponentenversionen.

Musterkomponentenausgabe sample-component-output

Um die Download-Komponente sowie Beispiele für die Konfigurationsoptionen sowie HTML- und JSON-Ausgaben zu erhalten, besuchen Sie die Komponentenbibliothek.

Technische Details technical-details

Die aktuelle technische Dokumentation zur Download-Komponente finden Sie auf GitHub.

Weitere Informationen zur Entwicklung von Kernkomponenten finden Sie in der Dokumentation zu Kernkomponenten für Entwickler.

Dialogfeld „Konfigurieren“ configure-dialog

Mit dem Dialogfeld „Konfigurieren“ kann der Inhaltsautor das Download-Element und sein Verhalten und Aussehen für einen Besucher der Seite definieren.

Registerkarte „Asset“ auf dem Dialogfeld „Bearbeiten“ der Download-Komponente

Registerkarte „Asset“ asset-tab

Die Auswahl eines Download-Assets ähnelt der Funktionalität der Bildkomponente und nutzt gleichermaßen das AEM-DAM.

  • Asset herunterladen

    • Ziehen Sie ein Asset aus dem Asset-Browser oder tippen Sie auf die Option Durchsuchen, um es von einem lokalen Dateisystem hochzuladen.
    • Tippen oder klicken Sie auf Löschen, um das aktuell ausgewählte Bild zu deaktivieren.
    • Tippen oder klicken Sie auf Bearbeiten, um die Ausgabedarstellungen des Assets im Asset-Editor zu verwalten.

Registerkarte „Eigenschaften“ properties-tab

Registerkarte „Eigenschaften“ auf dem Dialogfeld „Bearbeiten“ der Download-Komponente

  • Titel - Wird als Überschrift für das Download-Element angezeigt

    • Titel von DAM-Asset abrufen - Wenn ausgewählt, wird der Titel automatisch mit dem Titel des DAM-Assets ausgefüllt.
  • Beschreibung - Zeigt eine beschreibende Unterüberschrift des Download-Elements an

    • Beschreibung von DAM-Asset abrufen - Wenn ausgewählt, wird die Beschreibung automatisch mit der Beschreibung des DAM-Assets ausgefüllt.
  • Aktionstext - Zeigt Aktionstext für das Download-Element an

    • Dieses Feld ist beim Hochladen eines Assets aus dem Dateisystem erforderlich.
    • Inline anzeigen - Wenn ausgewählt, wird der angegebene Aktionstext inline angezeigt.
  • ID  – Diese Option dient zur Kontrolle der eindeutigen Kennung der Komponente in der HTML-Datei und auf der Datenschicht.

    • Wenn Sie das Feld leer lassen, wird automatisch eine eindeutige ID generiert, die Sie über die resultierende Seite finden.
    • Sofern eine ID angegeben wird, ist vom Autor bzw. der Autorin sicherzustellen, dass diese eindeutig ist.
    • Änderungen der ID können sich auf das CSS-, JS- und Datenschicht-Tracking auswirken.

Registerkarte „Arten“ styles-tab-edit

Registerkarte „Arten“ im Dialogfeld „Bearbeiten“ der Download-Komponente

Die Download-Komponente unterstützt das AEM-Stilsystem.

Verwenden Sie das Dropdown-Menü, um die Stile auszuwählen, die Sie auf die Komponente anwenden möchten. Die im Dialogfeld „Bearbeiten“ vorgenommenen Auswahlen haben denselben Effekt wie die in der Komponenten-Symbolleiste ausgewählten.

Stile müssen für diese Komponente im Dialogfeld „Design“ konfiguriert werden, damit das Dropdown-Menü verfügbar ist.

Dialogfeld „Design“ design-dialog

Das Dialogfeld „Design“ ermöglicht es dem Vorlagenautor, die Optionen für den Inhaltsautor zu definieren, der die Download-Komponente verwendet.

Registerkarte „Eigenschaften“ properties-tab-design

Dialogfeld „Design“ der Download-Komponente

  • Uploads aus Dateisystem zulassen - Ermöglicht dem Inhaltsautor das Hochladen eines Assets aus seinem lokalen Dateisystem als Download-Asset.
    • Der Standardwert ist nicht ausgewählt.
  • Titeltyp - Das HTML-Element, das für den Titel der Download-Komponente verwendet wird.
    • Wenn kein Wert ausgewählt ist, lautet der Standardwert H3.
  • Dateigröße anzeigen - Wenn ausgewählt, wird die Dateigröße des Assets in der Download-Komponente angezeigt.
    • Der Standardwert ist ausgewählt.
  • Dateiformat anzeigen - Wenn ausgewählt, wird das Dateiformat des Assets in der Download-Komponente angezeigt.
    • Der Standardwert ist ausgewählt.
  • Dateiname anzeigen - Wenn ausgewählt, wird der Dateiname des Assets in der Download-Komponente angezeigt.
    • Der Standardwert ist ausgewählt.

Registerkarte „Arten“ styles-tab

Die Bildkomponente unterstützt das AEM-Stilsystem.

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c