Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Permite criar uma chave de internacionalização com uma tradução automática (ou manual) para cada um dos idiomas configurados. O retorno do bloco ocorrerá apenas para o idioma configurado no navegador (aplicação web) ou no sistema operacional (aplicação mobile).
Image Added
texto internacionalizado
Permite a tradução de uma string de um idioma base para um ou mais idiomas alvo
Image Removed
Figura 1 - Bloco text_i18n
Informações |
---|
Não é possível digitar na área de texto do bloco, toda configuração é feita através da janela Internacionalizar, exibida após clicar no ícone do bloco. |
Compatibilidade
- Bloco cliente (web/mobile): this. cronapi.i18n.translate()
Retorno
Retorna uma string traduzida para um ou mais idiomas.
Parâmetros
<Lista dos parâmetros do bloco. Informar "Bloco sem parâmetros" caso não possua.>
<Nome do parâmetro>
<Descrição do Parâmetro 1>
- Posição: 1.
- Inglês: <Nome do parâmetro em inglês>.
- Tipo: <tipo do conteúdo esperado pelo parâmetro: "Texto / String", "Boolean / Booleano", "Lista de objetos / Object list">.
- Exemplo: <Exemplo do que o parâmetro deve receber: "Texto", 2 (número), true (boleano)>.
- Opções: <Se o parâmetro possuir um bloco anexo com dropdown, criar uma sublista com as opções e descrever cada uma delas, caso necessário. Caso esse bloco anexo possua documentação, linkar para essa documentação>.
Exemplo
<Descrever um exemplo de uso desse bloco. Utilizar um exemplo simples e real. Mostrar a figura do bloco configurado e o resultado obtido, quando existir>
<Mostrar o bloco configurado>
o texto no idioma solicitado, caso o idioma solicitado não exista na configuração do bloco, retornará no idioma padrão, português.
Parâmetros
Por padrão, o bloco não possui parâmetros, mas é possível incluir parâmetros para especificar palavras ou trechos que não devem ser traduzidos com o uso de expressões. Os parâmetros são criados ao incluir expressões com chaves e números ("{0}, {1},
…, {n}
") dentro do texto. Veja detalhes no tópico Exemplo 2.
Características do bloco
O bloco de programação text_i18n funciona a partir de requisições HTTP, onde ele busca o cabeçalho Accept-Language do navegador. Esse cabeçalho armazena uma lista de idiomas configurados pelo usuário. O bloco busca no cabeçalho o idioma definido pelo usuário e, caso não encontre a chave de internacionalização em nenhum idioma configurado no navegador, retornará a tradução no idioma padrão do bloco, que é o Português.
Para entender mais sobre o cabeçalho Accept-Language, clique aqui.
Além dos idiomas padrões, inglês (EUA) e português (Brasil), é possível escolher entre uma ampla gama de idiomas através do editor de internalização. Acesse o tópico Chave de internacionalização da documentação Internacionalização para mais detalhes.
Os arquivos de internacionalização, com a chave informada e as traduções ficam em diretórios distintos a depender da aplicação. Esses diretórios são acessíveis apenas com o Cronapp no Modo Avançado.
- Mobile:
src/main/mobileapp/www/i18n/
- Web:
src/main/webapp/i18n/
Image Added
Figura 2 - Configuração e estrutura da janela Internacionalizar
- Botão: abre a janela Internacionalizar
- Chave de internacionalização: campo que permite criar ou utilizar uma chave de internacionalização existente. Utilize o recurso de auto completar para exibir as chaves existentes.
- Campos de internacionalização: exibe um campo para cada idioma configurado na funcionalidade Internacionalização. É possível informar manualmente a tradução de cada idioma, ou informar o texto em um dos campos e realizar a tradução automática (passos 4 e 5).
- Idioma para tradução automática: selecione o idioma do campo que contém o texto para incluir a tradução automática nos demais campos.
- Traduzir: traduzir o texto do campo selecionado para todos os outros campos.
Exemplo 1
No exemplo da figura abaixo, estamos criando a chave de internacionalização "minhaChave
" com o texto "O menino joga futebol" em português (Brasil), sua tradução automática para "The boy plays soccer" em inglês (Estados Unidos) e "Il ragazzo gioca a calcio" em italiano (Itália).
Para abrir a janela de configuração, clique no ícone do bloco (destaque 1 da figura 2.1). Em seguida, informe a chave de internalização, neste exemplo criamos a chave chamada "minhaChave
" (destaque 2 da figura 2.1). Através da caixa de seleção (destaque 3 da figura 2.1), escolha o idioma de origem da tradução. Informe o texto "O menino joga futebol" no campo português (Brasil) (destaque 4 da figura 2.1), clique no botão amarelo (destaque 5 da figura 2.1) para que o texto seja automaticamente traduzido para o inglês no campo inglês (Estados Unidos) (destaque 6 da figura 2.1) e para o italiano (Itália) (destaque 7 da figura 2.1).
Image Added
Figura 2.1 - Configuração da string a ser traduzida
Este bloco leva em conta o idioma configurado no navegador, ou seja, ele irá converter a string que passamos no bloco para o idioma configurado no navegador. Para este exemplo, estamos utilizando o navegador na linguagem italiana, por isso, o texto será traduzido para o italiano, o mesmo pensamento se aplica para o caso do navegador estar em inglês.
Image Added
Figura 2.2 - Texto traduzido para o italiano
Âncora exemplo2 exemplo2
Exemplo 2
Embora a função não permita inicialmente a passagem de parâmetros, é possível criá-los ao definir a string a ser traduzida, utilizando valores numéricos inteiros entre chaves, como por exemplo {0}
. Os valores passados como parâmetros não serão traduzidos. No exemplo apresentado na figura abaixo, estamos criando uma frase com três parâmetros, enquanto o navegador está configurado para o idioma inglês.
Image Added
Figura 3 - Configuração dos parâmetros
O resultado dessa configuração pode ser conferido na imagem 3.1.
Image Added
Figura 3.1 - Resultado da configuração dos parâmetrosFigura 2.1 - <Descrição da figura>
Nesta página
Índice |
---|