Permite a tradução de uma string de em um idioma base para um ou mais idiomas alvo. o O bloco permite configurar múltiplos idiomas, porém o retorno do bloco irá se basear no ocorrerá apenas para o idioma configurado no navegador (aplicação web) ou no sistema operacional (aplicação mobile).
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): cronapi.i18n.translate()
Retorno
Retorna uma string traduzida para um ou mais idiomasum texto traduzido com base no idioma configurado.
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:
| appendIcon | info-circle |
|---|
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/
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 para os outros idiomas selecionados. O campo campo chave é utilizado para identificar unicamente um bloco de tradução, para mais informações acesse a documentação Internacionalização.
| Nota |
|---|
| 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 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 Embora a função não permitir permita inicialmente a passagem de parâmetros, é possível criá-los no momento da definição da ao definir a string a ser traduzida, através do uso de um valor numérico inteiro utilizando valores numéricos inteiros entre chaves, como por exemplo {0}, os . Os valores passados nos como parâmetros não serão traduzidos. No exemplo da apresentado na figura abaixo, estamos criando uma frase com três parâmetros em uma frase, dessa vez configuramos , enquanto o navegador no está configurado para o 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
Nesta página
| Índice |
|---|