Karussellkomponente carousel-component
Mit der Kernkomponente „Karussellkomponente“ kann der Inhaltsautor Inhalte in einem navigierbaren Karussell präsentieren.
Nutzung usage
Mit der Karussellkomponente organisiert der Inhaltsautor Inhalte in einem drehbaren Karussell aus Folien.
Das Dialogfeld „Bearbeiten“ ermöglicht dem Inhaltsautor das Erstellen, Benennen und Anordnen mehrerer Folien sowie die Aktivierung des automatischen Übergangs mit Verzögerung. Über das Dialogfeld „Design“ kann der Vorlagenautor definieren, welche Komponenten dem Karussell hinzugefügt werden können, automatische Übergänge aktivieren oder deaktivieren und die Stile anpassen.
Version und Kompatibilität version-and-compatibility
Die aktuelle Version der Karussellkomponente ist v1, die mit Version 2.2.0 der Kernkomponenten im Oktober 2018 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 Karussellkomponente zu erleben und Beispiele für ihre Konfigurationsoptionen sowie die HTML- und JSON-Ausgabe zu sehen, besuchen Sie die Komponentenbibliothek.
Technische Details technical-details
Die aktuelle technische Dokumentation zur Karussellkomponente finden Sie auf GitHub.
Weitere Informationen zur Entwicklung von Kernkomponenten finden Sie in der Dokumentation zu Kernkomponenten für Entwickler.
Tiefe Verknüpfung mit einem Bedienfeld deep-linking
Die Karussell-, Registerkarten- und Akkordeon-Komponenten unterstützen direkte Links zu einem Bedienfeld innerhalb der Komponente.
Gehen Sie hierfür wie folgt vor:
- Zeigen Sie die Seite mit der Komponente über die Option Als veröffentlicht anzeigen im Seiteneditor an.
- Überprüfen Sie den Inhalt der Seite und halten Sie die ID des Bedienfeldes fest.
- Beispiel
id="carousel-bfe4fa6647-item-47f1a7ca67-tabpanel"
- Beispiel
- Die ID wird der Anker, den Sie über einen Hash (
#) an die URL anhängen können.- Beispiel
https://wknd.site/content/wknd/language-masters/en/magazine/western-australia.html#carousel-bfe4fa6647-item-47f1a7ca67-tabpanel
- Beispiel
Wird zu der URL mit der Bereichs-ID navigiert, scrollt der Browser direkt zur jeweiligen Komponente und zeigt das angegebene Bedienfeld an. Wenn das Bedienfeld so konfiguriert ist, dass es nicht standardmäßig angezeigt wird, wird automatisch dorthin gescrollt.
Karussell und responsives Design responsive-design
Alle Kernkomponenten sind so konzipiert, dass sie vollständig responsiv sind und auf allen Geräten ein nahtloses Erlebnis bieten.
Einige erweiterte Komponenten wie die Karussellkomponente erfordern möglicherweise besondere Überlegungen im Kontext des Implementierungsprojekts, um unter allen Bedingungen die Reaktionsfähigkeit zu bewahren. Weitere Informationen finden Sie im Dokument Responsives Design der Kernkomponenten.
Dialogfeld „Bearbeiten“ edit-dialog
Im Dialogfeld „Bearbeiten“ kann der Inhaltsautor Folien hinzufügen, umbenennen und neu anordnen sowie die Einstellungen für den automatischen Übergang definieren.
Registerkarte „Elemente“ items-tab
Verwenden Sie die Schaltfläche Hinzufügen, um die Komponentenauswahl zu öffnen und dort auszuwählen, welche Komponente als Registerkarte hinzugefügt werden soll. Nach dem Hinzufügen wird der Liste ein Eintrag hinzugefügt, der die folgenden Spalten enthält:
- Symbol - Das Symbol des Komponententyps der Registerkarte zur einfachen Identifizierung in der Liste. Bewegen Sie den Mauszeiger darüber, um den vollständigen Komponentennamen als QuickInfo zu sehen.
- Beschreibung - Die Beschreibung, die als Text der Registerkarte verwendet wird und standardmäßig den Namen der für die Registerkarte ausgewählten Komponente enthält.
- Entfernen - Tippen oder klicken Sie, um die Registerkarte aus der Registerkartenkomponente zu löschen.
- Neu sortieren - Tippen oder klicken und ziehen Sie, um die Registerkarten anzuordnen.
Registerkarte „Eigenschaften“ properties-tab
Auf der Registerkarte Eigenschaften können Inhaltsautorinnen und -autoren die Folien auf automatische Übergänge einstellen.
-
Aktives Element: Inhaltsautorinnen und -autoren können definieren, welche Registerkarte beim Laden der Seite aktiv ist.
-
Automatisch zwischen Folien wechseln - Wenn diese Option aktiviert ist, wechselt die Komponente nach einer festgelegten Verzögerungszeit automatisch zur nächsten Folie.
-
Übertragungsverzögerung - Wenn die Option „Automatisch zwischen Folien wechseln“ ausgewählt wird, wird dieser Wert verwendet, um die Verzögerung zwischen Übergängen (in Millisekunden) zu definieren.
-
Automatisches Pausieren beim Bewegen des Mauszeigers deaktivieren - Wenn die Option Automatisch zwischen Folien wechseln ausgewählt ist, wird der Karussell-Übergang automatisch angehalten, sobald die Maus über das Karussell bewegt wird; Wählen Sie diese Option, damit der Übergang nicht angehalten wird.
-
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 „Erreichbarkeit“ accessibility-tab
Auf der Registerkarte Erreichbarkeit können Werte für die ARIA-Barrierefreiheits-Beschriftungen für die Komponente festgelegt werden.
- Beschriftung: Wert eines aria-label-Attributs für das Karussell, das den Karussellinhalt beschreibt.
- Zurück: Wert eines aria-label-Attributs für die Beschriftung der Zurück-Schaltfläche bei der Karussellnavigation.
- Weiter: Wert eines aria-label-Attributs für die Beschriftung der Weiter-Schaltfläche bei der Karussellnavigation.
- Wiedergabe: Wert eines aria-label-Attributs für die Beschriftung der Wiedergabe-Schaltfläche bei der Karussellnavigation.
- Pause: Wert eines aria-label-Attributs für die Beschriftung der Pause-Schaltfläche bei der Karussellnavigation.
- Registerkartenliste: Wert eines aria-label-Attributs für die Beschriftung der Elementliste bei der Karussellnavigation.
- Beschriftung des Karussellelements auf seinen Titel festlegen: Wenn diese Option aktiviert ist, wird der Titel der Karussellelemente automatisch auf die aria-label-Beschreibung festgelegt.
Bedienfeld auswählen select-panel
Der Inhaltsautor kann die Option Bedienfeld auswählen in der Komponentensymbolleiste verwenden, um zu einer anderen Folie zu wechseln und die Reihenfolge der Folien einfach neu zu ordnen.
Nach Auswahl der Option Bedienfeld auswählen in der Komponentensymbolleiste werden die konfigurierten Folien als Dropdown-Liste angezeigt.
- Die Liste wird durch die zugewiesene Anordnung der Folien angeordnet und entsprechend nummeriert.
- Der Komponententyp der Folie wird zuerst angezeigt, gefolgt von der Beschreibung der Folie in heller Schrift.
- Durch Tippen oder Klicken auf einen Eintrag in der Dropdown-Liste wird die Ansicht im Editor auf diese Folie umgestellt.
- Die Folie kann mithilfe der Ziehpunkte neu angeordnet werden.
Dialogfeld „Design“ design-dialog
Im Dialogfeld „Design“ kann der Vorlagenautor definieren, welche Komponenten der Karussellkomponente als Folien hinzugefügt werden können, sowie Standardübergänge und benutzerdefinierte Stile definieren, die dem Inhaltsautor zur Verfügung stehen.
Registerkarte „Eigenschaften“ properties-tab-1
Über die Registerkarte Eigenschaften werden die Standardeinstellungen für die Folienübergänge definiert, wenn ein Inhaltsautor die Karussellkomponente einer Seite hinzufügt.
- Automatisch zwischen Folien wechseln - Definiert, ob die Option, automatisch das Karussell auf die nächste Folie zu verschieben, aktiviert ist, wenn der Inhaltsautor die Karussellkomponente einer Seite hinzufügt.
- Steuerelemente voranstellen: Wenn diese Option aktiviert ist, werden die Steuerelemente vor den Karussellelementen platziert, um die Barrierefreiheit zu verbessern.
Registerkarte „Zugelassene Komponenten“ allowed-components-tab
Über die Registerkarte Zugelassene Komponenten können Sie definieren, welche Komponenten der Karussellkomponente von Inhaltsautorinnen und Inhaltsautoren als Folien hinzugefügt werden können.
Die Registerkarte „Zugelassene Komponenten“ funktioniert auf die gleiche Weise wie die Registerkarte desselben Namens beim Definieren der Richtlinie und Eigenschaften eines Layout-Containers im Vorlageneditor.
Registerkarte „Arten“ styles-tab
Die Karussellkomponente unterstützt das AEM-Stilsystem.
Adobe Client-Datenschicht data-layer
Die Karussellkomponente unterstützt die Adobe Client-Datenschicht.