Show Menu
TOPICS×

Language Navigation Component

O Componente de Navegação de Idioma fornece um idioma/navegação por país para um site, para que os visitantes possam navegar até a mesma página em uma localidade diferente.

Uso

Geralmente, os sites são fornecidos em vários idiomas para diferentes regiões. O componente de navegação de idioma permite que um visitante visualização a mesma página em idiomas/localidades diferentes. Então se você é um leitor da versão suíça alemã do site, você pode facilmente mudar para a versão em inglês dos EUA da mesma página. O componente de Navegação de idioma lida com a compreensão da estrutura do idioma do site e encontra a página correspondente automaticamente.
  • Para obter um exemplo de como o recurso de localização do Componente de navegação de idioma funciona, consulte a seção abaixo .
  • Para ver um exemplo de como os recursos de localização dos outros Componentes principais trabalham em conjunto, consulte a página Recursos de Localização dos Componentes principais.
A caixa de diálogo de edição permite a definição da raiz de navegação global do site, bem como a profundidade na estrutura que a navegação deve percorrer. Usando a caixa de diálogo de design, o autor do modelo pode definir os valores padrão para as mesmas opções.

Versão e compatibilidade

A versão atual do Componente de navegação de idioma é a v1, que foi introduzida com a versão 2.0.0 dos Componentes principais em janeiro de 2018, e é descrita neste documento.
A tabela a seguir detalha todas as versões compatíveis do componente, as versões do AEM com as quais as versões do componente são compatíveis e os links para a documentação de versões anteriores.
Versão do componente
AEM 6.4
AEM 6.5
AEM as a Cloud Service
v1
Compatível
Compatível
Compatível
Para obter mais informações sobre versões e lançamentos dos Componentes principais, consulte as Versões dos Componentes principais do documento.

Exemplo de saída de componente

Para experimentar o Componente de navegação de idioma e ver exemplos de suas opções de configuração, bem como a saída HTML e JSON, visite a Biblioteca de componentes.

Detalhes técnicos

A documentação técnica mais recente sobre o Componente de navegação de idiomas pode ser encontrada no GitHub .
Para obter mais detalhes sobre o desenvolvimento dos Componentes principais, consulte a documentação do desenvolvedor dos Componentes principais.

Caixa de diálogo Design

A caixa de diálogo de edição permite a definição da raiz de navegação global do site, bem como a profundidade na estrutura que a navegação deve percorrer.
Normalmente, essas configurações precisam ser feitas somente no nível do modelo da página. No entanto, eles podem ser alterados no nível da página por meio da caixa de diálogo de edição.

Guia Propriedades

  • Raiz da navegação
    • É aqui que a navegação de idioma do site deve ser start.
    • A estrutura de idioma do site começa no próximo nível abaixo dessa raiz.
  • Profundidade da estrutura do idioma
    • Esta é a quantidade de níveis da árvore de conteúdo abaixo da Raiz
      de
      navegação que representa a estrutura de idioma do site. Exemplos:
      • 1
        tipicamente significa que você só tem a escolha do idioma.
      • 2
        tipicamente significa que você tem uma escolha de idioma e país.
      • 3
        normalmente significa que você tem uma escolha de idioma, país e região.

Exemplo

Digamos que seu conteúdo se parece com isso:
/content +-- wknd +-- language-masters +-- us +-- en \-- es \-- ch +-- de +-- fr \-- it +-- wknd-events \-- wknd-shop
Para o WKND do site, você provavelmente gostaria de colocar o componente de Navegação de idioma em um modelo de página como parte do cabeçalho. Uma vez que parte do modelo, você pode definir a Raiz
de
navegação do componente como
/content/wknd
sendo aquele em que seu conteúdo localizado começa. Você também gostaria de definir a Profundidade
da Estrutura de
Idioma como sendo
2
de dois níveis (país e idioma).
Com o valor Raiz
de
navegação, o Componente de linguagem sabe que depois disso a navegação começa e pode gerar opções de navegação de idioma reconhecendo os próximos dois níveis na árvore de conteúdo como a estrutura de navegação de idioma do site (conforme definido pelo valor de Profundidade
/content/wknd
da estrutura de
​idiomas).
Independentemente da página que um usuário esteja visualizando, o componente de Navegação de idioma pode encontrar a página correspondente em outro idioma, ao saber o local da página atual e ao trabalhar de trás para a raiz e, em seguida, encaminhar para a página correspondente.

Guia Estilos

O componente de navegação de idioma suporta o sistema de estilo AEM.

Edit Dialog

Geralmente, o componente de Navegação de idioma só precisa ser adicionado e configurado nos modelos de página de um site. No entanto, se o componente de Navegação de idioma precisar ser adicionado a uma página de conteúdo individual, a caixa de diálogo de edição permitirá que um autor de conteúdo configure os mesmos valores conforme descrito na caixa de diálogo de design.
Além disso, é possível definir uma
ID
. Essa opção permite controlar o identificador exclusivo do componente no HTML e na Camada de dados.
  • Se deixado em branco, uma ID exclusiva é gerada automaticamente para você e pode ser encontrada inspecionando a página resultante.
  • Se uma ID for especificada, é responsabilidade do autor garantir que seja exclusiva.
  • A alteração da ID pode afetar o CSS, o JS e o rastreamento da camada de dados.