Mudanças entre as edições de "Desenvolvedor:APIs/JavaScript/latromi.formManager/setOnFieldValueChangedCallback(function)"

De LATROMI Manuais
Desenvolvedor:APIs/JavaScript/latromi.formManager/setOnFieldValueChangedCallback(function)
Ir para: navegação, pesquisa
(→‎Exemplos)
 
(2 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 3: Linha 3:
  
 
'''Membro de:''' [[DEV:APIs/JavaScript/latromi.formManager|latromi.formManager]]
 
'''Membro de:''' [[DEV:APIs/JavaScript/latromi.formManager|latromi.formManager]]
−
'''Uso'': Estático
 
−
 
 
== Sintaxe ==
 
== Sintaxe ==
 
<syntaxhighlight lang="JavaScript">
 
<syntaxhighlight lang="JavaScript">
Linha 24: Linha 22:
  
 
=== Utilizando o contexto ===
 
=== Utilizando o contexto ===
−
O exemplo a seguir, mostra como interceptar o disparo de um evento do Formulário Dinâmico. O código executa as seguintes ações:
+
O exemplo a seguir, mostra como interceptar a alteração de valor de um campo do Formulário Dinâmico. O código executa as seguintes ações:
−
* Verifica se é um evento de campo.
+
* Mostra no console do navegador o nome do campo e novo valor atribuído a ele.
−
* Se for um evento de campo, mostra no console do navegador o nome do campo e nome do evento disparado.
 
−
* Se for outro tipo de evento, mostra apenas o nome do evento.
 
−
 
 
−
<syntaxhighlight lang="JavaScript">
 
−
latromi.formManager.setOnEventFiringCallback( function(context) {
 
−
  if (context.eventKind === 'Field')
 
−
      console.log('Evento ' + context.eventName + ' do campo ' + context.field.name + ' disparado.');
 
−
  else
 
−
      console.log('Evento ' + context.eventName + ' disparado.')
 
−
});
 
−
</syntaxhighlight>
 
  
−
=== Cancelando um evento ===
 
−
O exemplo a seguir, mostra como cancelar o processamento de um evento no servidor. O código executa as seguintes ações:
 
−
* Verifica se o evento disparado foi o ''Click'' do botão ''btnFakeButton''. Se for, executa as ações:
 
−
** Cancela o processamento do evento no servidor.
 
−
** Mostra no console do navegador uma mensagem notificando o cancelamento do evento.
 
 
<syntaxhighlight lang="JavaScript">
 
<syntaxhighlight lang="JavaScript">
−
latromi.formManager.setOnEventFiringCallback( function(context) {
+
latromi.formManager.setOnFieldValueChangedCallback( function(context) {
−
   if (context.eventKind  === 'Field'  
+
   console.log('Valor do campo ' + context.field.name + ' alterado para: ' + context.field.getValue());
−
      && ontext.field.name === 'btnFakeButton'  
 
−
      && context.eventName === 'Click')
 
−
  {
 
−
      context.cancel = true;
 
−
      console.log('O Evento Click do botão btnFakeButton foi cancelado.');
 
−
  }
 
 
});
 
});
 
</syntaxhighlight>
 
</syntaxhighlight>

Edição atual tal como às 15h48min de 9 de julho de 2018

Especifica uma função de callback, que será chamada quando o valor de algum campo for alterado via programaticamente (via processamento no servidor ou API JavaScript). A função não será chamada quando o valor do campo for alterado pelo usuário.

Membro de: latromi.formManager

Sintaxe

function setOnFieldValueChangedCallback(callback) { 
   var context = new latromi.fieldValueChangedContext();
   callback(context); 
}

Parâmetros

callback
Tipo: function (fieldValueChangedContext)
Função de callback, esperando um parâmetro do tipo fieldValueChangedContext. Neste parâmetro estarão disponíveis as informações de contexto do evento.

Valor de Retorno

Sem retorno.

Exemplos

Utilizando o contexto

O exemplo a seguir, mostra como interceptar a alteração de valor de um campo do Formulário Dinâmico. O código executa as seguintes ações:

  • Mostra no console do navegador o nome do campo e novo valor atribuído a ele.
latromi.formManager.setOnFieldValueChangedCallback( function(context) {
   console.log('Valor do campo ' + context.field.name + ' alterado para: ' + context.field.getValue());
});
Disponível em "http://docs.latromi.com.br/index.php?title=Desenvolvedor:APIs/JavaScript/latromi.formManager/setOnFieldValueChangedCallback(function)&oldid=1768"