Obter valor do campo
Obtém o valor do campo originário de uma conteúdo de um campo do componente fonte de dados ou de um campo da tela.
Bloco do parâmetro Campo
O bloco Obter nome do campo já vem conectado ao Parâmetro Campo e tem o objetivo de facilitar a seleção de um componente do formulário.
outro componente que possua a propriedade Valor (ng-model). Este bloco é utilizado em conjunto com o bloco Obter nome do campo.
Figura 1 - Bloco Obter nome do campo
Parâmetros
Nome
Tipo
Doc
Compatibilidade
Servidor
Cliente
Exemplo
valor do campo
| Informações |
|---|
Este bloco também pode ser utilizado para obter os valores dos componentes Lista avançada e Grade. Seu retorno depende de como a propriedade Obter valor do campo como está configurada nesses componentes, podendo ser como Chave ou Objeto. Para mais detalhes, acesse o tópico Aba Geral das documentações Lista avançadae Grade. |
Compatibilidade
- Bloco cliente: cronapi.screen.getValueOfField()
Retorno
Retorna o conteúdo obtido do componente selecionado.
Parâmetros
Campo
Valor (ng-model) do componente que terá o seu conteúdo obtido. 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"
Exemplo 1 - Obtendo valor
A função a seguir apresenta um exemplo de uso do bloco Obter valor do campo. Após vincular um formulário de referência nas configurações do bloco, a função "Obter Valor" (Figura 2) inicia com a variável "valCampo" recebendo o bloco Obter valor do Campo, o qual no parâmetro Campo recebe o valor do campo "vars.entradaTexto" que será o valor de referência do componente Entrada de texto, em seguida, no bloco Exibir Notificação é selecionado no parâmetro Tipo o valor Sucesso e no parâmetro Mensagem a variável "valCampo".
Figura 2 - Bloco Obter valor do campo
Após isso, a função "Obter Valor" é atribuída ao evento Ao Clicar do botão e ao clicá-lo na aplicação, aparece a notificação do tipo sucesso com o valor digitado no componente Entrada de texto (Figura 3).
Figura 3 - Retorno da função referente à Figura 2
blockly, inserimos na variável "valorCampo" o bloco Obter valor do campo e, nele, selecionamos, no parâmetro Campo, o valor (ng-model) de um componente entrada de texto presente no formulário. Em seguida, o bloco Exibir Notificação exibirá uma notificação contendo o conteúdo da variável "valorCampo".
Figura 2 - Exemplo de uso do bloco Obter valor do campo
A função da Figura 2 foi adicionada ao evento "Ao Clicar" do botão "Obter valor do campo". Ao clicar neste botão, o conteúdo do componente entrada de texto será obtido e exibido em uma notificação (Figura 2.1).
Figura 2.1 - Resultado de execução da função da Figura 2
Exemplo 2 - Caixa de Seleção Múltipla
Neste exemplo, atribuímos o ng-model do componente visual Caixa de seleção múltipla, configurada para retornar Objeto, à variável "item". Esta, por sua vez, alimenta o bloco Obter valor do campo, associado a variável "valorCampo". Utilizamos um laço de repetição pra percorrer a lista e acessar todos os elementos selecionados na caixa de seleção múltipla e com a ajuda do bloco imprime e Obter Propriedade, exibimos o nome dos usuários no console do navegador.
Figura 3 - Componente Caixa de seleção múltipla em conjunto com o bloco Obter valor do campo
Ao executar o projeto, selecionamos os nomes dos alunos na caixa de seleção múltipla e, em seguida, acionamos a função através do evento "Ao Clicar" do botão "Obter valor do campo". O resultado da execução da função da Figura 3 pode ser conferido abaixo.
Figura 3.1 - Resultado da execução da função da Figura 3
Exemplo 3 - Obtendo o objeto
Ao clicar no ícone indicado pela seta na Figura 4, é possível selecionar o objeto da fonte de dados manualmente, basta escrever o <nomeDaFonteDeDados>.data. Neste exemplo, selecionamos o objeto "Aluno" no parâmetro Campo, dessa forma, ao executar a função, o objeto da fonte de dados será exibido no console do navegador.
Figura 4 - Fonte de dados no bloco Obter valor do campo
A Figura 4.1 exibe a quantidade de itens na grade.
Figura 4.1 - Grade contendo os alunos
O resultado da execução da função da Figura 4 pode ser conferido abaixo.
Figura 4.2 - Resultado da execução da função da Figura 4
Nesta página
| Índice |
|---|
Vincular formulário
Para selecionar Valor (ng-model) da Grade no parâmetro Campo, é necessário apontar a view desejada no campo Formulário de referência das configurações do Editor de Bloco de programação.
| title | Mais sobre |
|---|