Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Permite a tradução de uma string de um idioma base para um ou mais idiomas alvo


Figura 1 - Bloco text_i18n

Compatibilidade

  • Bloco cliente (web/mobile): this.cronapi.i18n.translate()

Retorno

Retorna uma string traduzida para um ou mais idiomas.

Parâmetros

<Lista dos parâmetros do bloco. Informar "Bloco sem parâmetros" caso não possua.>

<Nome do parâmetro>

<Descrição do Parâmetro 1>

  • Posição: 1.
  • Inglês: <Nome do parâmetro em inglês>.

  • Tipo: <tipo do conteúdo esperado pelo parâmetro: "Texto / String", "Boolean / Booleano", "Lista de objetos / Object list">.
  • Exemplo

    : <Exemplo do que o parâmetro deve receber: "Texto", 2 (número), true (boleano)>.

  • Opções: <Se o parâmetro possuir um bloco anexo com dropdown, criar uma sublista com as opções e descrever cada uma delas, caso necessário. Caso esse bloco anexo possua documentação, linkar para essa documentação>.
  • Exemplo

    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 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. - Texto traduzido para o italiano

    Criação de parâmetros

    Apesar de inicialmente a função não permitir passagem de parâmetros, é possível criá-los no momento da definição da string a ser traduzida, através do uso de um valor numérico inteiro entre chaves dentro do campo valor, como por exemplo {0}.

    Nesta página

    Índice