Sprachnavigationskomponente
Die Sprachnavigationskomponente stellt eine Sprache/Ländernavigation für eine Site bereit, sodass Besucher zur gleichen Seite in einem anderen Gebietsschema navigieren können.
TIPPNutzung
Webseiten werden oft in verschiedenen Sprachen für verschiedene Regionen angeboten. Mit der Sprachnavigationskomponente kann ein Besucher dieselbe Seite in verschiedenen Sprachen/Gebietsschemata anzeigen. Wenn Sie ein Leser auf der schweizerischen deutschen Version der Website sind, können Sie einfach zur US-englischen Version der gleichen Seite wechseln. Die Sprachnavigationskomponente verarbeitet die Struktur der Site-Sprache und findet die zugehörige Seite automatisch.
- Ein Beispiel dafür, wie die Lokalisierungsfunktion der Sprachnavigationskomponente funktioniert, finden Sie unten.
- Ein Beispiel dafür, wie die Lokalisierungsfunktionen der anderen Kernkomponenten zusammenarbeiten, finden Sie auf der Seite Kernkomponenten unter „Lokalisierungsfunktionen“.
Das Dialogfeld Bearbeiten ermöglicht die Definition des globalen Site-Navigationsstamms sowie die Festlegung, wie tief in die Struktur die Navigation gehen soll. Im Dialogfeld Design kann der Vorlagenautor die Standardwerte für dieselben Optionen festlegen.
Version und Kompatibilität
Die aktuelle Version der Sprachnavigationskomponente 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.
| Komponentenversion | AEM 6.4 | AEM 6.5 | AEM 6.5 LTS | AEM as a Cloud Service |
|---|---|---|---|---|
| v2 | – | Kompatibel | Kompatibel | Kompatibel |
| v1 | Kompatibel | Kompatibel | – | Kompatibel |
Weitere Informationen zu Kernkomponentenversionen und -freigaben finden Sie im Dokument Kernkomponentenversionen.
Musterkomponentenausgabe
Um die Sprachnavigationskomponente und Beispiele für die Konfigurationsoptionen sowie HTML- und JSON-Ausgaben zu erhalten, besuchen Sie die Komponentenbibliothek.
Technische Details
Die aktuelle technische Dokumentation zur Sprachnavigationskomponente finden Sie auf GitHub.
Weitere Informationen zur Entwicklung von Kernkomponenten finden Sie in der Dokumentation zu Kernkomponenten für Entwickler.
Dialogfeld „Design“
Das Dialogfeld „Bearbeiten“ ermöglicht die Definition des globalen Site-Navigationsstamms sowie die Festlegung, wie tief die Navigation in die Struktur gehen darf.
In der Regel müssen diese Konfigurationen nur auf der Seitenvorlage vorgenommen werden. Sie können jedoch auch über das Dialogfeld „Bearbeiten“ auf der Seitenebene geändert werden.
Registerkarte „Eigenschaften“
-
Navigationsstamm
- Hier sollte die Sprachnavigation der Site beginnen.
- Die Sprachstruktur der Site beginnt auf der nächsten Ebene unter diesem Stamm.
-
Sprachstrukturtiefe
-
So stellen die zahlreichen Ebenen der Inhaltsstruktur unter dem Navigationsstamm die Sprachstruktur der Site dar. Beispiele:
1bedeutet normalerweise, dass Sie nur die Sprache auswählen können.2bedeutet normalerweise, dass Sie eine Sprache und ein Land auswählen können.3bedeutet normalerweise, dass Sie Sprache, Land und Region auswählen können.
-
Beispiel
Nehmen wir an, dass Ihr Inhalt wie folgt aussieht:
/content
+-- wknd
+-- language-masters
+-- us
+-- en
\-- es
\-- ch
+-- de
+-- fr
\-- it
+-- wknd-events
\-- wknd-shop
Für die Site „WKND“ möchten Sie auf einer Seitenvorlage womöglich die Sprachnavigationskomponente als Teil der Kopfzeile platzieren. Sobald die Komponente ein Teil der Vorlage ist, können Sie den Navigationsstamm der Komponente auf /content/wknd festlegen, da dort der lokalisierte Inhalt für diese Site beginnt. Sie sollten auch die Sprachstrukturtiefe auf 2 festlegen, da Ihre Struktur aus zwei Ebenen besteht (erst Land, dann Sprache).
Mit dem Navigationsstamm-Wert weiß die Sprachkomponente, dass nach /content/wknd die Navigation beginnt und dass sie Sprachnavigationsoptionen generieren kann, indem die nächsten beiden Ebenen in der Inhaltsstruktur als Sprachnavigationsstruktur der Site erkannt werden (wie durch den Wert der Sprachstruktur definiert).
Unabhängig davon, welche Seite ein Benutzer ansieht, kann die Sprachnavigationskomponente die entsprechende Seite in einer anderen Sprache finden, indem sie den Speicherort der aktuellen Seite kennt, den Stamm rückwärts entlang arbeitet und dann auf die entsprechende Seite weiterleitet.
