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

De LATROMI Manuais
Desenvolvedor:APIs/JavaScript/latromi.formManager
Ir para: navegação, pesquisa
(Exemplos)
Linha 33: Linha 33:
  
 
== Exemplos ==
 
== Exemplos ==
 +
=== Manipulando eventos do Formulário ===
 +
<syntaxhighlight lang="JavaScript">
 +
var MyForm = function () {
 +
  function onFormCreatedPrivate(arguments) {
 +
      console.log('Formulário Criado.');
 +
  }
 +
 +
  function onEventFiringPrivate(arguments){
 +
      console.log('Evento ' + arguments.eventName + ' disparado.');
 +
  }
 +
 +
  function onFieldValueChangedPrivate(arguments){
 +
      console.log('O valor do campo ' + arguments.field.name + ' foi alterado.');
 +
  }
 +
 +
  return {
 +
      // Delega a escuta do evento para funções privadas
 +
      // (não pode ser acessadas de fora deste objeto)
 +
      onFormCreated        : onFormCreatedPrivate,
 +
      onEventFiring        : onEventFiringPrivate,
 +
      onFieldValueChanged  : onFieldValueChangedPrivate
 +
  }
 +
};
 +
 +
// Declara o objeto criado
 +
var myForm = new MyForm();
 +
 +
// Adiciona callbacks no Formulário
 +
latromi.formManager.setOnFormCreatedCallback( myForm.onFormCreated );
 +
latromi.formManager.setOnEventFiringCallback( myForm.onEventFiring );
 +
latromi.formManager.setOnFieldValueChangedCallback( myForm.onFieldValueChanged );
 +
</syntaxhighlight>

Edição das 15h40min de 9 de julho de 2018

Gerenciador de Formulários Dinâmicos. Esse objeto não precisa ser estanciado pois é um objeto estático.

Sintaxe

latromi.formInstance = function () {
      return {
         setOnFormCreatedCallback       : function (callback)    { },
         setOnEventFiringCallback       : function (callback)    { },
         setOnFieldValueChangedCallback : function (callback)    { },
         getFormInstance                : function (upgradeCode) { }
      }
}

Métodos

Nome Descrição
getFormInstance(string) Retorna um objeto do tipo latromi.formInstance, referente a um Formulário Dinâmico carregado na tela.
setOnFormCreatedCallback(function) Callback disparado quando o Formulário for criado na página.
setOnEventFiringCallback(function) Callback disparado quando um evento for disparado.
setOnFieldValueChangedCallback(function) Callback disparado quando o valor de um campo for alterado.

Exemplos

Manipulando eventos do Formulário

var MyForm = function () {
   function onFormCreatedPrivate(arguments) {
      console.log('Formulário Criado.');
   }

   function onEventFiringPrivate(arguments){
      console.log('Evento ' + arguments.eventName + ' disparado.');
   }

   function onFieldValueChangedPrivate(arguments){
      console.log('O valor do campo ' + arguments.field.name + ' foi alterado.');
   }

   return {
      // Delega a escuta do evento para funções privadas 
      // (não pode ser acessadas de fora deste objeto)
      onFormCreated        : onFormCreatedPrivate,
      onEventFiring        : onEventFiringPrivate,
      onFieldValueChanged  : onFieldValueChangedPrivate
   }
};

// Declara o objeto criado
var myForm = new MyForm();

// Adiciona callbacks no Formulário
latromi.formManager.setOnFormCreatedCallback( myForm.onFormCreated );
latromi.formManager.setOnEventFiringCallback( myForm.onEventFiring );
latromi.formManager.setOnFieldValueChangedCallback( myForm.onFieldValueChanged );