Permite a tradução de uma string base para o idioma alvo, sendo que o idioma base pode ser o português e o alvo inglês ou vice-versa.
Figura 1 - Bloco text_i18n
Compatibilidade
- Bloco servidor: cronapi.i18n.Operations.translate().
Retorno
Retorna uma string traduzida do idioma base para o idioma alvo.
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. 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, ele busca o cabeçalho Accept-Language do navegador, este cabeçalho é responsável por armazenar qual o idioma atual e quais idiomas estão configurados no navegador. O bloco irá procurar neste cabeçalho o idioma que ele foi configurado para traduzir, caso ele não o encontre, o retorno será feito no idioma padrão do bloco, Português. Para entender mais sobre o cabeçalho Accept-Language, clique aqui.
Exemplo 1
O bloco de internacionalização text_i18n permite a definição de uma string a ser convertida de um idioma base para outro. No exemplo da figura abaixo estamos convertendo a string "O menino joga futebol" para o idioma inglês (Estados Unidos).
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 para o ingês. O campo chave é utilizado para identificar unicamente um bloco de tradução, para mais informações acesse a documentação Internacionalização.
Para que a função de tradução da string possa ter efeito, é necessário que o valor passado esteja no mesmo idioma base selecionado no menu de seleção vertical (destaque 4 da figura 2).
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 inglês (en-US), por isso o texto será traduzido para o inglês, o mesmo pensamento se aplica para o caso do navegador estar em português. Abaixo apresentamos o resultado obtido da requisição feita pelo bloco ao navegador. Para fazer as requisições utilizamos o aplicativo de testes de API's, Insominia.
Figura 2.1 - Tradução feita a partir da requisição do bloco text_i18n
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 dois parâmetros, enquanto o navegador está configurado para o idioma português.
Para conseguir inserir o texto em inglês no bloco, primeiramente precisamos alterar o idioma da IDE para inglês, acesse o menu do sistema e siga os seguintes passos Espaço de trabalho > Idiomas > Inglês, ao final recompile e reabra a IDE
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
Nesta página