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

De LATROMI Manuais
Desenvolvedor:APIs/JavaScript/latromi.formManager/setOnFormCreatedCallback(function)
Ir para: navegação, pesquisa
(Inicializando uma API ao criar o Formulário)
Linha 15: Linha 15:
 
=== Parâmetros ===
 
=== Parâmetros ===
 
: ''callback''
 
: ''callback''
:: Tipo: function (object)
+
:: Tipo: function ([[DEV:APIs/JavaScript/latromi.formCreatedContext|formCreatedContext]])
:: Função de callback, esperando um parâmetro do tipo ''Object''. Neste parâmetro estarão disponíveis as informações de contexto do evento.
+
:: Função de callback, esperando um parâmetro do tipo [[DEV:APIs/JavaScript/latromi.formCreatedContext|formCreatedContext]]. Neste parâmetro estarão disponíveis as informações de contexto da criação do formulário.
  
 
=== Valor de Retorno ===
 
=== Valor de Retorno ===

Edição das 14h15min 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 setOnFormCreatedCallback(callback) { 
   var arguments = {
      form: { } // Instância de latromi.formInstance
   };
   callback(arguments); 
}

Parâmetros

callback
Tipo: function (formCreatedContext)
Função de callback, esperando um parâmetro do tipo formCreatedContext. Neste parâmetro estarão disponíveis as informações de contexto da criação do formulário.

Valor de Retorno

Sem retorno.

Exemplos

Inicializando um Objeto ao criar o Formulário

O exemplo a seguir mostra como inicializar uma API que será usada apenas em um Formulário específico. O código executa as seguintes ações:

  • Verifica se o formulário que foi criado na página é o detentor do Código de Atualização FRM00000267600002420180709131720350305.
  • Se o teste acima for verdadeiro, inicializar o objeto myApi, passando no construtor o valor do campo txtApiValue.
var myApiInstance;

latromi.formManager.setOnFormCreatedCallback( function(context) {
   // Se for um formulário especifico, inicializa a API.
   if (context.form.upgradeCode === 'FRM00000267600002420180709131720350305') {
      myApiInstance = new myApi(context.form.getFieldValue('txtApiValue'));
      myApiInstance.init();
   }
});