Suprir Texto (Cliente) / Supply Text (Client)
Função que formata o texto substituindo os valores entre chaves ({ }) pelos termos desejados.
Figura 1 - Bloco Suprir Texto
Compatibilidade
Bloco cliente: cronapi.text.formatTextWithReplacement()
Retorno
Retorna uma string com o texto alterado conforme os termos especificados nos parâmetros.
Características do bloco
O bloco Suprir Texto é configurado originalmente com dois parâmetros: Texto e Termo. No entanto, é possível adicionar mais parâmetros "Termo" conforme necessário. Para isso, clique no ícone de configuração do bloco e arraste para a função quantos blocos "item" forem necessários para gerar os parâmetros adicionais.
Figura 2 - Adicionando mais parâmetros "Termo"
Parâmetros
Texto
Este parâmetro recebe o texto que será modificado, com os pontos de substituição indicados entre chaves e em ordem numérica.
Posição: 1
Inglês: Text
Tipo: Numérico, Data e Tempo / Number, Date and Time
Exemplo: "{0} comprou {1} carro no dia {2}."
Termo
Termos utilizados para substituir os valores que estão entre chaves no primeiro parâmetro. Serão contados de cima para baixo em ordem numérica.
Posição: 2 ou mais
Inglês: Term
Tipo: Objeto / Object
Exemplo: "Ana", "1", "29/10/2024"
Exemplo
Na função abaixo, o bloco Suprir Texto altera os valores entre chaves ({ }) contidos no parâmetro "Texto" com base nos "Termos" informados nos demais parâmetros. O resultado de execução será impresso no console do navegador.
Figura 3 - Exemplo de uso do bloco Suprir Texto
A imagem a seguir apresenta o resultado de execução da função da Figura 3 no console do navegador.
Figura 3.1 - Resultado de execução da função da Figura 3
Nesta página