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.
- Die Eigenschaften der Download-Komponente können im Dialogfeld „Konfigurieren“ ausgewählt werden.
- Standardwerte für die Download-Komponente können im Dialogfeld „Design“ definiert werden.
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.
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“ 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
-
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
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
- 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.