Show Menu
TOPICS×

Experience Fragment-Komponente

Mit der Kernkomponente Experience Fragment-Komponente kann der Inhaltsautor eine Experience Fragment-Variation auf einer Seite platzieren, während er eine lokalisierte Site-Struktur unterstützt.

Nutzung

Mit der Kernkomponente Experience Fragment-Komponente kann der Inhaltsautor aus vorhandenen Experience Fragment-Variationen auswählen und eine davon auf der Inhaltsseite platzieren. Die Experience Fragment-Komponente unterstützt außerdem eine lokalisierte Site-Struktur.
  • Die Eigenschaften der Komponente können im Dialogfeld Konfigurieren definiert werden.
  • Die Standardeinstellungen für die Komponente beim Hinzufügen zu einer Seite können im Dialogfeld Design definiert werden.

Unterstützung für lokalisierte Site-Strukturen

Die Experience Fragment-Komponente ist an lokalisierte Site-Strukturen anpassbar und gibt das richtige Experience-Fragment basierend auf der Lokalisierung der Seite wieder. Hierfür muss das Experience Fragment die folgenden Bedingungen erfüllen:
  • Die Experience Fragment-Komponente wird zu einer Vorlage hinzugefügt.
  • Diese Vorlage wird verwendet, um eine neue Inhaltsseite zu erstellen, die Teil einer lokalisierten Struktur unter
    /content/<site>
    ist.
  • Das auf einer Inhaltsseite referenzierte Experience Fragment ist Teil einer lokalisierten Experience Fragment-Struktur unter
    /content/experience-fragments
    ; dieselben Muster wie bei der Site unter
    /content/<site>
    werden befolgt, einschließlich der gleichen Komponentennamen.
In diesem Fall wird das Fragment mit derselben Lokalisierung (Sprache, Blueprint oder Live Copy) wie die aktuelle Seite als Teil der Vorlage gerendert.
Dieses Verhalten ist auf Experience Fragment-Komponenten beschränkt, die zu Vorlagen hinzugefügt werden. Experience Fragment-Komponenten, die einzelnen Inhaltsseiten hinzugefügt werden, rendern die exakten Experience Fragment-Komponenten, die innerhalb der Komponente konfiguriert wurden.
  • Ein Beispiel für die Funktionsweise der Lokalisierungsfunktionen der Experience Fragment-Komponente finden Sie im folgenden Abschnitt.
  • Ein Beispiel dafür, wie die Lokalisierungsfunktionen der Hauptkomponenten zusammenarbeiten, finden Sie auf der Seite "Hauptkomponenten"unter Lokalisierungsfunktionen .

Beispiel

Nehmen wir an, dass Ihr Inhalt wie folgt aussieht:
/content +-- experience-fragments \-- we-retail +-- language-masters +-- us +-- en +-- footerTextXf \-- headerTextXf \-- es +-- footerTextXf \-- headerTextXf \-- ch +-- de +-- footerTextXf \-- headerTextXf +-- fr +-- footerTextXf \-- headerTextXf \-- it +-- footerTextXf \-- headerTextXf +-- we-retail +-- language-masters +-- us +-- en \-- es +-- ch +-- de +-- fr \-- it +-- wknd-events \-- wknd-shop
Beachten Sie, dass sich die Struktur unter
/content/experience-fragments/we-retail
auf die Struktur von
/content/we-retail
auswirkt.
Wenn die Experience Fragment-Komponente
/content/experience-fragments/we-retail/us/en/footerTextXf
in einer Vorlage platziert wird, rendern die lokalisierten Seiten, die basierend auf dieser Vorlage erstellt wurden, automatisch das lokalisierte Experience Fragment, welches der lokalisierten Inhaltsseite entspricht.
Wenn Sie also zu einer Inhaltsseite unter
/content/we-retail/ch/de
navigieren, welche dieselbe Vorlage verwendet, wird
/content/experience-fragments/we-retail/ch/de/footerTextXf
anstatt von
/content/experience-fragments/we-retail/us/en/footerTextXf
gerendert.

Notfallversorgung

Die Experience Fragment-Komponente wird wie folgt versuchen, eine entsprechende lokalisierte Komponente zu finden.
  1. Zuerst wird versucht, einen Sprachstamm zu finden.
  2. Wird dieser nicht gefunden, wird versucht, ein Blueprint zu finden.
  3. Wenn auch dieses nicht gefunden werden, versucht sie, eine Live Copy zu finden.
  4. Falls keine Live-Copy gefunden wurde, wird standardmäßig das in der Komponente konfigurierte Experience Fragment verwendet.

Version und Kompatibilität

Die aktuelle Version der Experience Fragment-Komponente ist Version 1, die mit Version 2.6.0 der Core-Komponenten im September 2019 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.3
AEM 6.4
AEM 6.5
v1
Kompatibel
Kompatibel
Kompatibel
Weitere Informationen zu Kernkomponentenversionen und -freigaben finden Sie in den Kernkomponentenversionen .

Musterkomponentenausgabe

To experience the Experience Fragment Component as well as see examples of its configuration options as well as HTML and JSON output, visit the Component Library .

Technische Details

Die neueste technische Dokumentation zur Experience Fragment-Komponente finden Sie auf GitHub .
Weitere Informationen zur Entwicklung von Kernkomponenten finden Sie in der Dokumentation zu Kernkomponenten für Entwickler .

Dialogfeld „Konfigurieren“

Das Dialogfeld „Konfigurieren“ ermöglicht dem Inhaltsautor die Auswahl der Experience Fragment-Variation, die auf der Seite gerendert werden soll.
Verwenden Sie die Schaltfläche
Auswahldialog öffnen
, um die Komponentenauswahl zu öffnen und auszuwählen, welche Variation der Experience Fragment-Komponente zur Inhaltsseite hinzugefügt werden soll.
Wenn Sie die Experience Fragment-Komponente zu einer Vorlage hinzufügen, wird sie automatisch lokalisiert, sofern die Experience Fragments lokalisiert sind. Was auf der Seite gerendert wird, kann sich daher von der Komponente unterscheiden, die Sie explizit auswählen. Weitere Informationen finden Sie im oben stehenden Beispiel .

Dialogfeld „Design“

Über das Dialogfeld „Design“ kann der Vorlagenautor die Optionen definieren, die dem Inhaltsautor zur Verfügung stehen, der die Experience Fragment-Komponente verwendet, sowie auch die Standardeinstellungen, die beim Platzieren der Experience Fragment-Komponente festgelegt wurden.
Die Experience Fragment-Komponente unterstützt das AEM- Stilsystem .