Experience Fragment-Komponente (v1) experience-fragment-component
Mit der Kernkomponente „Experience Fragment-Komponente“ kann der Inhaltsautor eine Experience Fragment-Variante auf einer Seite platzieren, während er eine lokalisierte Site-Struktur unterstützt.
Nutzung usage
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.
Version und Kompatibilität version-and-compatibility
In diesem Dokument wird die v1 der Experience Fragment-Komponente beschrieben, die mit Version 2.6.0 der Kernkomponenten im September 2019 eingeführt wurde.
Unterstützung für lokalisierte Site-Strukturen localized-site-structure
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 dafür, wie die Lokalisierungsfunktion der Experience Fragment-Komponente funktioniert, finden Sie unten.
- Ein Beispiel dafür, wie die Lokalisierungsfunktionen der Kernkomponenten zusammenarbeiten, finden Sie in den Lokalisierungsfunktionen auf der Kernkomponenten-Seite.
Beispiel example
Nehmen wir an, dass Ihr Inhalt wie folgt aussieht:
/content
+-- experience-fragments
\-- wknd
+-- language-masters
+-- us
+-- en
+-- footerTextXf
\-- headerTextXf
\-- es
+-- footerTextXf
\-- headerTextXf
\-- ch
+-- de
+-- footerTextXf
\-- headerTextXf
+-- fr
+-- footerTextXf
\-- headerTextXf
\-- it
+-- footerTextXf
\-- headerTextXf
+-- wknd
+-- language-masters
+-- us
+-- en
\-- es
+-- ch
+-- de
+-- fr
\-- it
+-- wknd-events
\-- wknd-shop
Beachten Sie, dass sich die Struktur unter /content/experience-fragments/wknd auf die Struktur von /content/wknd auswirkt.
Wenn die Experience Fragment-Komponente /content/experience-fragments/wknd/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/wknd/ch/de navigieren, welche dieselbe Vorlage verwendet, wird /content/experience-fragments/wknd/ch/de/footerTextXf anstatt von /content/experience-fragments/wknd/us/en/footerTextXf gerendert.
Notfallversorgung fallback
Die Experience Fragment-Komponente wird wie folgt versuchen, eine entsprechende lokalisierte Komponente zu finden.
- Zuerst wird versucht, einen Sprachstamm zu finden.
- Wird dieser nicht gefunden, wird versucht, ein Blueprint zu finden.
- Wenn auch dieses nicht gefunden werden, versucht sie, eine Live Copy zu finden.
- Falls keine Live-Copy gefunden wurde, wird standardmäßig das in der Komponente konfigurierte Experience Fragment verwendet.
Musterkomponentenausgabe sample-component-output
Rufen Sie die Komponentenbibliothek auf, um die Experience Fragment-Komponente sowie die Beispiele für ihre Konfigurationsoptionen und die HTML- und JSON-Ausgabe zu testen.
Technische Details technical-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“ configure-dialog
Das Dialogfeld „Konfigurieren“ ermöglicht dem Inhaltsautor die Auswahl der Experience Fragment-Variante, 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.
Sie können auch eine ID festlegen. 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.
Dialogfeld „Design“ design-dialog
Ü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.
Registerkarte „Arten“ styles-tab
Die Experience Fragment-Komponente unterstützt das AEM-Stilsystem.