Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Permite a tradução de uma string em um idioma base para um ou mais idiomas alvo. O bloco permite configurar múltiplos idiomas, porém o retorno do bloco 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 um texto traduzido com base no idioma configurado.
Parâmetros
Bloco sem 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
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.
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 para 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.
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
Âncora exemplo2 exemplo2
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 três parâmetros, enquanto o navegador 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 |
---|