Mudanças entre as edições de "Desenvolvedor:APIs/JavaScript/latromi.formManager/setOnEventFiringCallback(function)"
Desenvolvedor:APIs/JavaScript/latromi.formManager/setOnEventFiringCallback(function)
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. | ||
− | + | <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 | + | 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 14h38min 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.'); } });