Alterar valor do campo
valor textualParâmetros de Entrada
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | obj | Componente a ter seu valor alterado |
| Parâmetro 2 | string | Conteúdo em texto para alteração |
Servidor
Cliente
Exemplo 1
A função abaixo altera o valor do componente vars.entradaTexto, aplicando o conteúdo "Novo texto alterado" .
Utilização da função
A utilização da função alterar valor do campo depende da forma correta de vinculação do bloco de programação ao formulário contendo o componente a ter seu valor alterado.
Para mais informações sobre como fazer a vinculação acesse o link abaixo.
| Informações | ||
|---|---|---|
| ||
Sobre o bloco
Para que se possa ter acesso aos componentes do formulário dentro do bloco, é preciso alterar a propriedade campo do componente.
Alteração da propriedade campo
Após alterada a propriedade, o componente fica visível dentro do seletor do bloco como pode-se ver abaixo.
Pode ser utilizado com vários componentes, por exemplo:
- Entrada de texto, informando um texto;
- Caixa de checagem, passando valores booleanos;
- Caixa de seleção dinâmica, informando o identificador de uma das opções da Fonte de dados vinculada.
Figura 1 - Bloco Alterar valor do campo
Compatibilidade
- Bloco cliente: cronapi.screen.changeValueOfField()
- Bloco servidor: cronapi.screen.changeValueOfField() - executado a partir da chamada do bloco cliente.
Retorno
Bloco não possui retorno.
Parâmetros
Campo
Valor (ng-model) do componente de texto que terá o seu conteúdo alterado. Para selecioná-lo é necessário vincular o bloco de programação a um formulário de referência, confira no tópico Propriedades do Blockly da documentação Bloco de Programação.
- Posição: 1
- Inglês: Field
- Tipo: Objeto / Object
- Exemplo: "
vars.input197"
Valor
Conteúdo que será atribuído ao componente de texto informado.
- Posição: 2
- Inglês: Value
- Tipo: Texto / String
- Exemplo: "Novo conteúdo"
Exemplo
A função a seguir apresenta um exemplo de uso do bloco Alterar valor do campo. Após vincular um formulário de referência nas configurações do blockly, selecionamos, no parâmetro Campo do bloco, o valor (ng-model) de um componente entrada de texto presente no formulário.
Figura 2 - Exemplo de uso do bloco Alterar valor do campo
A função da Figura 2 foi adicionada ao evento "Ao Clicar" do botão "Alterar valor do campo". Ao clicar neste botão, o conteúdo do componente Entrada de texto será alterado para o informado no bloco da função (Figura 2.1).
Figura 2.1 - Resultado de execução da função da Figura 2
Nesta página
| Índice |
|---|