Internacionalizar componentes

Última atualização: 4 de maio de 2023

Criado para:

  • Desenvolvedor
CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Internacionalize seus componentes e diálogos para que suas strings da interface do usuário possam ser apresentadas em idiomas diferentes. Os componentes projetados para internacionalização permitem que as cadeias de caracteres da interface do usuário sejam externalizadas, traduzidas e importadas para o repositório. No tempo de execução, as preferências de idioma do usuário ou a localidade da página determinam qual idioma é exibido na interface do usuário.

chlimage_1-9

Use o seguinte processo para internacionalizar seus componentes e fornecer a interface do usuário em diferentes idiomas:

  1. Implemente seus componentes usando o código que internacionaliza as cadeias de caracteres. Seu código identifica as cadeias de caracteres a serem traduzidas e seleciona o idioma a ser apresentado no tempo de execução.

  2. Criar dicionários e adicionar as strings em inglês a serem traduzidas.

  3. Exportar o dicionário para o formato XLIFF, traduza as cadeias de caracteres e importar os arquivos XLIFF retornam ao AEM. Como alternativa, você pode adicionar traduções manualmente ao dicionário.

  4. Incorpore o dicionário ao processo de gerenciamento de versões do seu aplicativo.

NOTE
Os métodos descritos aqui para internacionalizar componentes destinam-se à tradução de strings estáticas. Quando as sequências de componentes devem mudar, você deve usar os fluxos de trabalho de tradução convencionais. Por exemplo, quando os autores podem editar uma sequência de caracteres da interface do usuário usando propriedades na caixa de diálogo Editar de um componente, você não deve usar um dicionário de idiomas para internacionalizar a sequência de caracteres.

Dicionários de idioma

A estrutura de internacionalização de AEM usa dicionários no repositório para armazenar strings em inglês e suas traduções em outros idiomas. A estrutura usa inglês como o idioma padrão. As cadeias de caracteres são identificadas usando sua versão em inglês. Normalmente, as estruturas de internacionalização usam IDs alfanuméricas para strings da interface do usuário. Usar a versão em inglês da string como a ID tem várias vantagens:

  • O código é fácil de ler.
  • O idioma padrão está sempre disponível.

As strings localizadas podem ser armazenadas em vários dicionários no repositório. Os dicionários do sistema de AEM estão localizados abaixo do /libs nó . Você pode criar dicionários para seus componentes abaixo do /apps nó . O quadro de internacionalização da AEM combina os dicionários e os disponibiliza no Sling como um único ResourceBundle objeto. Quando os componentes são renderizados, eles recuperam cadeias de caracteres traduzidas do pacote de recursos. Os dicionários combinados também são implantados no servidor da Web em formato JSON para fornecer strings traduzidas ao código Javascript nas páginas da Web.

Além disso, a variável Ferramenta Tradução permite gerenciar todos os dicionários de um local central.

chlimage_1-10

NOTE
Não modifique os dicionários do sistema de AEM que estão localizados abaixo do /libs nó .

Sobreposição de strings nos dicionários do sistema

Strings em dicionários abaixo da variável /apps o nó substitui cadeias de caracteres duplicadas nos dicionários que estão abaixo do /libs nó . Se os componentes usarem strings incluídas nos dicionários do sistema de AEM, duplique a string em seu próprio dicionário. Todos os componentes usarão as cadeias de caracteres do seu dicionário.

Observe que você não pode prever qual tradução será usada quando as cadeias de caracteres forem duplicadas em dicionários que estão todos localizados abaixo do valor /apps nó .

Página anterior
Próxima página

Experience Manager