Listenkomponente

Die Kernkomponente „Listenkomponente“ ermöglicht die einfache Erstellung dynamischer sowie statischer Listen.

Verwendung

Die Listenkomponente kann beispielsweise zum Erstellen einer dynamischen Liste von untergeordneten Seiten oder einer statischen Liste von willkürlich definierten Elementen verwendet werden. Der Typ der verfügbaren Listen und Formatierungsoptionen kann vom Vorlagenautor im Dialogfeld „Design“ definiert werden. Der Inhaltseditor kann aus verfügbaren Listentypen und Elementen zum Formatieren der Listen im Dialogfeld „Bearbeiten“ auswählen.

Version und Kompatibilität

Die aktuelle Version der Listen-Komponente ist v2, die mit Version 2.0.0 der Kernkomponenten im Januar 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.

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

Weitere Informationen zu Kernkomponentenversionen und -freigaben finden Sie in den Kernkomponentenversionen.

Musterkomponentenausgabe

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

Technische Details

Die aktuelle technische Dokumentation zur Listenkomponente finden Sie auf GitHub.

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

Dialogfeld „Bearbeiten“

Im Dialogfeld „Bearbeiten“ kann der Inhaltsautor die Liste und die Listenelemente konfigurieren.

Registerkarte „Listeneinstellungen“

Die Liste kann auf verschiedene Weise erstellt werden.

Unabhängig davon, wie die Liste erstellt wurde, stehen Optionen für Sortieren und ID zur Verfügung, die immer konfiguriert werden können.

Dialogfeld „Bearbeiten“ der Listenkomponente

Je nachdem, wie der Inhaltsautor die Liste erstellt, werden die zusätzlichen Konfigurationsoptionen geändert.

Untergeordnete Seiten

Die Liste kann aus den untergeordneten Seiten der aktuellen Seite oder einer anderen Seite bestehen.

Optionen für untergeordnete Seiten

  • Übergeordnete Seite

    • Die Seite, deren untergeordnete Seiten in die Liste aufgenommen werden sollen
    • Frei lassen, um aktuelle Seite zu verwenden
  • Untergeordnete Tiefe,
    Wie viele Ebenen in der Hierarchie angelegt werden sollten

Liste fester Werte

Die Liste kann mit einer Liste mit festen Elementen erstellt werden.

Optionen für Listen fester Werte

Tippen oder klicken Sie auf die Schaltfläche Hinzufügen, um ein neues Element in die Liste einzufügen.

  • Geben Sie Text für das Element in der Liste ein oder wählen Sie im Dialogfeld „Auswahl“ ein Element aus AEM aus.
  • Mit dem Ziehpunkt können Sie die Elemente in der Liste neu anordnen.
  • Verwenden Sie das Papierkorbsymbol, um Elemente in der Liste zu löschen.

Suche

Die Liste kann mithilfe der Ergebnisse einer Suche aus AEM-Inhalten erstellt werden.

Optionen für die Suchliste

  • Suchabfrage
    Die Zeichenfolge, für die eine Volltextsuche ausgeführt wird, um die Listenelemente zu generieren
  • Suchen in,
    Wo die Suche ausgeführt werden soll
    • Wählen Sie im Dialogfeld „Auswahl“ den Speicherort in AEM aus
    • Aktuelle Seite verwenden, wenn leer

Tags

Die Liste kann mithilfe von Seiten erstellt werden, die bestimmten Tags unter einem bestimmten Ort entsprechen.

Optionen für die Tag-Liste

  • Übergeordnete Seite
    Where the tag matching should startWo die Tag-Übereinstimmung beginnen sollte
    • Wählen Sie im Dialogfeld „Auswahl“ den Speicherort in AEM aus
    • Aktuelle Seite verwenden, wenn leer
  • Tags,
    Welche Tags sollten abgeglichen werden
    • Verwenden Sie das Dialogfeld Durchsuchen, um die Tags auszuwählen.
  • Übereinstimmung
    Definieren, welche Art von Übereinstimmung eine Seite qualifizieren soll, damit sie in die Liste aufgenommen wird
    • beliebiges Tag
    • alle Tags

Sortieroptionen

Unabhängig davon, wie Sie die Liste erstellen, gibt es bestimmte Sortieroptionen, die immer definiert werden können.

Sortieroptionen

  • Reihenfolge
    Anordnung der Elemente
    • Titel
    • Datum der letzten Änderung
  • Sortierreihenfolge
    Die Reihenfolge, in der die Elemente angeordnet werden sollen
    • Aufsteigend
    • Absteigend
  • Maximale Elementanzahl
    Maximale Anzahl der in der Liste angezeigten Elemente
    • Leer lassen, um alle Elemente zurückzugeben.
  • 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 sicherzustellen, dass diese eindeutig ist.
    • Änderungen der ID können sich auf das CSS-, JS- und Datenschicht-Tracking auswirken.

Registerkarte „Elementeinstellungen“

Auf der Registerkarte „Elementeinstellungen“ kann die Formatierung der Listenelemente konfiguriert werden.

Elementeinstellungen

  • Elemente verknüpfen
    Elemente mit der entsprechenden Seite verknüpfen
  • Beschreibung anzeigen
    Beschreibung des Link-Elements anzeigen
  • Datum anzeigen
    Änderungsdatum des Link-Elements anzeigen

Dialogfeld „Design“

Über das Dialogfeld „Design“ kann der Vorlagenautor festlegen, welche Listentypen für Inhaltsautoren erlaubt und welche Elementeinstellungen verfügbar sind.

Listen-Einstellungen

Auf der Registerkarte Listeneinstellungen kann das Datumsformat sowie der Listentyp definiert werden, der in der Komponente den Inhaltsautoren zur Verfügung stehen soll.

Listeneinstellung im Dialogfeld „Design“ der Listenkomponente

  • Datumsformat
    Format für die Anzeige des letzten Änderungsdatums
  • Untergeordnete Elemente deaktivieren
    Deaktiviert den Listentyp „untergeordnete Elemente“ in der Komponente
  • Statische Anzeige deaktivieren
    Deaktiviert den Listentyp „Statisch“ in der Komponente
  • Suche deaktivieren
    Deaktiviert den Listentyp „Suche“ in der Komponente
  • Tags deaktivieren
    Deaktiviert den Listentyp „Tags“ in der Komponente

Elementeinstellungen

Auf der Registerkarte Elementeinstellungen können die Formatierungsoptionen für die einzelnen Listenelemente definiert werden, die in der Komponente für die Inhaltsautoren verfügbar sein sollten.

Elementeinstellungen im Dialogfeld „Design“ der Listenkomponente

Registerkarte „Stile“

Die Bildkomponente unterstützt das AEM-Stilsystem.

Auf dieser Seite