Permite criar uma chave de internacionalização com uma tradução automática (ou manual) para cada um dos idiomas configurados. Durante a execução, o bloco irá verificar a língua configurada no cabeçalho da requisição e retornar a tradução desse idioma. Caso não encontre nenhum idioma configurado, retornará o idioma padrão, português.
Figura 1 - Bloco text_i18n
Atualmente esse bloco só dá suporte aos idiomas inglês e português. Para mais idiomas, utilize o bloco cliente text_i18n (cliente).
Compatibilidade
- Bloco servidor: cronapi.i18n.Operations.translate()
Retorno
Retorna 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 aos 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, 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.
Janela de configuração
A figura 2 apresenta a forma de configuração do bloco de programação text_i18n.
Figura 2 - Configuração da string a ser traduzida
- Botão: abre a janela Internacionalizar
- Área de texto para string a ser traduzida: neste campo escreveremos a string que queremos traduzir. O idioma escrito neste campo dever ser o mesmo selecionado na caixa de seleçãi (item 3).
- Caixa de seleção: neste campo indicaremos para qual idioma iremos traduzir a string passada na área de texto (item 2).
- Traduzir automaticamente: clicando neste botão, a string passada no item 2 será traduzida para o inglês automaticamente.
- Área de texto da tradução: apresenta a string do item 2 traduzida.
- Chave de internacionalização: campo que permite inserir o arquivo que contém a chave de internacionalização, este arquivo pode ser encontrado no caminho:
src/main/java/i18n/Messages_pt_BR.properties, acesse a documentação Internacionalização para mais detalhes. Após inserir a chave de internacionalização, o usuário não deve introduzir mais dados na área de texto (item 2), isso irá sobrescrever os dados de tradução anterior.
Exemplo 1
No exemplo da figura abaixo estamos realizando a tradução automática do texto "O menino joga futebol" (português (Brasil)) 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 o texto a ser traduzido (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 inglê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 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