Taalnavigatie-component language-navigation-component
De taalnavigatiecomponent biedt een taal-/landnavigatie voor een site, zodat bezoekers naar dezelfde pagina in een andere landinstelling kunnen navigeren.
Gebruik usage
Websites worden vaak in meerdere talen aangeboden voor verschillende regio's. Met de taalnavigatiecomponent kan een bezoeker dezelfde pagina in verschillende talen/landinstellingen bekijken. Dus als je een lezer bent op de Zwitserse Duitse versie van de website, kun je gemakkelijk overschakelen naar de Engelse versie van de Verenigde Staten van dezelfde pagina. Met de component Taalnavigatie krijgt u inzicht in de taalstructuur van de site en wordt de bijbehorende pagina automatisch gevonden.
- Voor een voorbeeld van hoe de lokalisatiefunctie van de Component van de Navigatie van de Taal werkt, zie het onderstaande gedeelte.
- Voor een voorbeeld van hoe de lokalisatiefuncties van de andere Core Components samenwerken, zie Localisatiefuncties van de pagina Core Components.
De dialoogvenster bewerken Hiermee kunt u de globale hoofdmap voor sitenavigatie definiëren en aangeven hoe diep de structuur van de navigatie moet zijn. Met de ontwerpdialoogvensterkan de sjabloonauteur de standaardwaarden voor dezelfde opties instellen.
Versie en compatibiliteit version-and-compatibility
De huidige versie van de taalnavigatiecomponent is v2, die in februari 2022 is geïntroduceerd met versie 2.18.0 van de kerncomponenten en in dit document wordt beschreven.
In de volgende tabel staan alle ondersteunde versies van de component, de AEM versies waarmee de versies van de component compatibel zijn en koppelingen naar documentatie voor vorige versies.
Raadpleeg het document voor meer informatie over versies en releases van de Core Component Core Components-versies.
Uitvoer van voorbeeldcomponent sample-component-output
Als u de taalnavigatiecomponent wilt ervaren en voorbeelden wilt zien van de configuratieopties en de HTML- en JSON-uitvoer, gaat u naar de Componentbibliotheek.
Technische details technical-details
De meest recente technische documentatie over de taalnavigatiecomponent kan op GitHub worden gevonden.
Meer informatie over het ontwikkelen van kerncomponenten vindt u in de Documentatie voor ontwikkelaars van kerncomponenten.
Ontwerpdialoogvenster design-dialog
In het dialoogvenster Ontwerpen kunt u de globale hoofdmap voor sitenavigatie definiëren en aangeven hoe diep de structuur van de navigatie in moet gaan.
Doorgaans hoeven deze configuraties alleen op paginasjabloonniveau te worden uitgevoerd. Deze kunnen echter op paginaniveau worden gewijzigd via de dialoogvenster bewerken.
Tabblad Eigenschappen properties-tab
-
Navigatieroot
- Hier moet de taalnavigatie van de site worden gestart.
- De taalstructuur van de site begint op het volgende niveau onder deze hoofdmap.
-
Diepte taalstructuur
-
Dit is het aantal niveaus van de inhoudsstructuur onder de Navigatieroot de taalstructuur van de site weergeven. Voorbeelden:
1doorgaans betekent dit dat u alleen de taal kunt kiezen.2doorgaans betekent dit dat u een keuze hebt tussen taal en land.3betekent doorgaans dat u een keuze hebt uit taal, land en regio.
-
Voorbeeld example
Laten we zeggen dat uw inhoud er ongeveer als volgt uitziet:
/content
+-- wknd
+-- language-masters
+-- us
+-- en
\-- es
\-- ch
+-- de
+-- fr
\-- it
+-- wknd-events
\-- wknd-shop
Voor de plaats WKND, zou u waarschijnlijk de component van de Navigatie van de Taal op een paginamalplaatje als deel van de kopbal willen plaatsen. Als een deel van de sjabloon is gemaakt, kunt u de Navigatieroot van de component /content/wknd aangezien dat de plaats is waar uw gelokaliseerde inhoud voor die plaats begint. U wilt ook de opdracht Diepte taalstructuur te worden 2 omdat uw structuur op twee niveaus ligt ( land en taal ) .
Met de Navigatieroot waarde, de Component van de Taal weet dat na /content/wknd dat de navigatie begint en taalnavigatieopties kan genereren door de volgende twee niveaus in de inhoudsstructuur te herkennen als de taalnavigatiestructuur van de site (zoals gedefinieerd door de Diepte taalstructuur waarde).
Ongeacht welke pagina een gebruiker bekijkt, kan de component van de Navigatie van de Taal de overeenkomstige pagina in een andere taal vinden, door de plaats van de huidige pagina te kennen en achterwaarts aan de wortel te werken, en dan door:sturen aan de overeenkomstige pagina.
Tabblad Stijlen styles-tab
De taalnavigatiecomponent ondersteunt de AEM Stijlsysteem.
Dialoogvenster Bewerken edit-dialog
Tabblad Eigenschappen properties-tab-edit
Doorgaans hoeft de component Taalnavigatie alleen aan de paginasjablonen van een site te worden toegevoegd en geconfigureerd. Als de component Taalnavigatie echter moet worden toegevoegd aan een afzonderlijke inhoudspagina, kan het dialoogvenster voor bewerken een auteur van de inhoud dezelfde waarden configureren als in het dialoogvenster ontwerpdialoogvenster
Bovendien kunt u een ID. Met deze optie kunt u de unieke id van de component in de HTML en in de Gegevenslaag.
- Als deze leeg blijft, wordt automatisch een unieke id voor u gegenereerd. U kunt deze vinden door de resulterende pagina te inspecteren.
- Als een id is opgegeven, is het de verantwoordelijkheid van de auteur om ervoor te zorgen dat deze uniek is.
- Het wijzigen van de id kan gevolgen hebben voor het bijhouden van CSS-, JS- en gegevenslagen.
Tabblad Toegankelijkheid accessibility-tab
- Label - Deze optie moet worden gedefinieerd als er meer dan één taalnavigatie op de pagina is om het aria-labelkenmerk van de component in te stellen.
Tabblad Stijlen styles-tab-edit
De taalnavigatiecomponent ondersteunt de AEM Stijlsysteem..
Gebruik de vervolgkeuzelijst om de stijlen te selecteren die u op de component wilt toepassen. Selecties in het dialoogvenster Bewerken hebben hetzelfde effect als de selecties op de werkbalk van de component.
De stijlen moeten voor deze component in worden gevormd ontwerpdialoogvenster zodat het vervolgkeuzemenu beschikbaar is.
Gegevenslaag Adobe-client data-layer
De taalnavigatiecomponent ondersteunt de Adobe Client Data Layer.