Språknavigeringskomponent language-navigation-component

Språknavigeringskomponenten är ett språk-/landsnavigeringssätt för en webbplats, så att besökare kan navigera till samma sida på en annan språkinställning.

Användning usage

Webbplatser finns ofta på flera språk för olika regioner. Med språknavigeringskomponenten kan besökaren visa samma sida på olika språk/språk. Om du läser på den schweiziska tyska versionen av webbplatsen kan du enkelt växla till den engelska versionen av samma sida. Komponenten Språknavigering hanterar förståelsen av webbplatsens språkstruktur och söker automatiskt efter motsvarande sida.

I redigeringsdialogrutan kan du definiera den globala platsnavigeringsroten samt hur djupt in i strukturen navigeringen ska gå. Med hjälp av designdialogrutan kan mallskaparen ange standardvärden för samma alternativ.

Version och kompatibilitet version-and-compatibility

Den aktuella versionen av språknavigeringskomponenten är v2, som introducerades i version 2.18.0 av grundkomponenterna i februari 2022, och som beskrivs i det här dokumentet.

Följande tabell visar alla versioner av komponenten som stöds, de AEM versionerna som komponenterna är kompatibla med och länkar till dokumentation för tidigare versioner.

Mer information om versioner och versioner av kärnkomponenter finns i dokumentet Core Components Versions.

Exempel på komponentutdata sample-component-output

Om du vill se både Language Navigation Component (Språknavigeringskomponenten) och exempel på dess konfigurationsalternativ samt HTML- och JSON-utdata går du till komponentbiblioteket.

Teknisk information technical-details

Den senaste tekniska dokumentationen om språknavigeringskomponenten finns på GitHub.

Mer information om hur du utvecklar kärnkomponenter finns i dokumentationen för kärnkomponentutvecklare.

Designdialogruta design-dialog

I designdialogrutan kan du definiera den globala platsnavigeringsroten samt hur djupt in i strukturen navigeringen ska gå.

Vanligtvis behöver dessa konfigurationer bara göras på sidmallsnivå. De kan dock ändras på sidnivå via redigeringsdialogrutan.

Fliken Egenskaper properties-tab

Exempel example

Låt oss säga att innehållet ser ut ungefär så här:

/content
+-- wknd
   +-- language-masters
   +-- us
      +-- en
      \-- es
   \-- ch
      +-- de
      +-- fr
      \-- it
+-- wknd-events
\-- wknd-shop

För webbplatsen WKND vill du förmodligen placera komponenten Språknavigering i en sidmall som en del av sidhuvudet. När du är en del av mallen kan du ange navigeringsrot för komponenten till /content/wknd eftersom det är där det lokaliserade innehållet för den platsen börjar. Du bör också ange språkstrukturdjupet till 2 eftersom strukturen är på två nivåer (land och sedan språk).

Med värdet Navigeringsrot vet språkkomponenten att efter /content/wknd som navigeringen börjar, och kan generera språknavigeringsalternativ genom att identifiera de två nästa nivåerna i innehållsträdet som webbplatsens språknavigeringsstruktur (som definieras av värdet Språkstrukturdjup ).

Oavsett vilken sida en användare visar kan komponenten Språknavigering hitta motsvarande sida på ett annat språk genom att känna till platsen för den aktuella sidan och arbeta bakåt till roten och sedan vidarebefordra till motsvarande sida.

Fliken Format styles-tab

Språknavigeringskomponenten stöder AEM Style System.

Dialogrutan Redigera edit-dialog

Fliken Egenskaper properties-tab-edit

Vanligtvis behöver komponenten Språknavigering bara läggas till och konfigureras på sidmallarna för en plats. Om komponenten Språknavigering måste läggas till på en enskild innehållssida kan en innehållsförfattare i redigeringsdialogrutan konfigurera samma värden som beskrivs i designdialogrutan

Dessutom kan du ange ett ID. Med det här alternativet kan du styra den unika identifieraren för komponenten i HTML och i datalagret.

Fliken Tillgänglighet accessibility-tab

Fliken Format styles-tab-edit

Språknavigeringskomponenten stöder AEM Style System..

Använd listrutan för att välja de format som du vill använda på komponenten. Markeringar som görs i redigeringsdialogrutan har samma effekt som de som väljs i komponentverktygsfältet.

Format måste konfigureras för den här komponenten i designdialogrutan för att den nedrullningsbara menyn ska vara tillgänglig.

Adobe-klientdatalager data-layer

Språknavigeringskomponenten stöder datalagret Adobe Client.