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

De LATROMI Manuais
Desenvolvedor:APIs/JavaScript/latromi.formManager/setOnEventFiringCallback(function)
Ir para: navegação, pesquisa
Linha 19: Linha 19:
 
=== Valor de Retorno ===
 
=== Valor de Retorno ===
 
Sem retorno.
 
Sem retorno.
 +
  
 
== Exemplos ==
 
== Exemplos ==
  
 +
=== 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:
 +
* Verifica se é um evento de campo.
 +
* 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.
  
Exemplo:
+
<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">
function test() {
+
latromi.formManager.setOnEventFiringCallback( function(context) {
 
+
  if (context.eventKind  === 'Field'
}
+
      && 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 das 13h38min de 9 de julho de 2018

Especifica uma função de callback, que será chamada quando o processo de criação do Formulário Dinâmico na página for concluído. Este evento ocorre apenas uma vez para cada página carregada.

Membro de: latromi.formManager

Sintaxe

function setOnEventFiringCallback(callback) { 
   var context = new latromi.formEventFiringContext();
   callback(context); 
}

Parâmetros

callback
Tipo: function (formEventFiringContext)
Função de callback, esperando um parâmetro do tipo formEventFiringContext. 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 o disparo de um evento do Formulário Dinâmico. O código executa as seguintes ações:

  • Verifica se é um evento de campo.
  • 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.
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.')
});

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.
latromi.formManager.setOnEventFiringCallback( function(context) {
   if (context.eventKind   === 'Field' 
      && ontext.field.name === 'btnFakeButton' 
      && context.eventName === 'Click') 
   {
      context.cancel = true;
      console.log('O Evento Click do botão btnFakeButton foi cancelado.');
   }
});