Permite a tradução de uma string de um idioma base para um ou mais idiomas alvo. o bloco permite configurar múltiplos idiomas, porém o retorno do bloco irá se basear no idioma configurado no navegador (aplicação web) ou no sistema operacional (aplicação mobile).

Figura 1 - Bloco text_i18n

Compatibilidade

• Bloco cliente (web/mobile): cronapi.i18n.translate()

Retorno

Retorna uma string traduzida para um ou mais idiomas.

Parâmetros

Bloco sem parâmetros.

Características do bloco

Além dos idiomas padrão do componente, 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. O conteúdo gerado pelo bloco fica em uma pasta chamada i18n (Localização:  ). 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.

Exemplo 1

O bloco de internacionalização text_i18n permite a definição de uma string a ser convertida de um idioma base para um ou mais idiomas. No exemplo da figura abaixo estamos convertendo a string "O menino joga bola" para dois outros idiomas, inglês (Estados Unidos) e italiano (Itália).

Para abrir a janela de configuração, clique no ícone do bloco (destaque 1 da figura 2), em seguida, iremos definir a string base (destaque 2 da figura 2). Clicando no botão "Traduzir a chave selecionada para outros idiomas" (destaque 3 da figura 2) o texto será traduzido automaticamente pra os outros idiomas selecionados. O campo chave é utilizado para identificar unicamente um bloco de tradução, para mais informações acesse a documentação Internacionalização.

Figura 2 - Configuração da string base 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.

Figura 2.1 - Texto traduzido para o italiano

Exemplo 2

Apesar de inicialmente a função não permitir passagem de parâmetros, é possível criá-los no momento da definição da string a ser traduzida, através do uso de um valor numérico inteiro entre chaves como por exemplo {0}, os valores passados nos parâmetros não serão traduzidos. No exemplo da figura abaixo estamos criando três parâmetros em uma frase, dessa vez configuramos o navegador no idioma inglês.

Figura 3 - Configuração dos parâmetros

O resultado dessa configuração pode ser conferido na imagem 3.1.

Figura 3.1 - Resultado da configuração dos parâmetros