Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 9 Próxima »

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


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 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 obtém 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

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 português (pt-BR), 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.


Figura 2.1 - Tradução feita a partir da requisição do bloco text_i18n









Nesta página

  • Sem rótulos