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
Linha 2: Linha 2:
 
Gerenciador de Formulários Dinâmicos. Essa fornece os seguintes objetos no lado do cliente:
 
Gerenciador de Formulários Dinâmicos. Essa fornece os seguintes objetos no lado do cliente:
  
{|class="wikitable apidoctable"
+
== Métodos ==
!Membro
+
 
! Retorno
+
{|class="wikitable apidoctable2"
 +
!Nome
 
! Descrição
 
! Descrição
 
|----------------------------------
 
|----------------------------------
 
|[[#getFormInstance|getFormInstance()]]
 
|[[#getFormInstance|getFormInstance()]]
|[[Dev:APIs/JavaScript/latromi.formInstance|latromi.formInstance]]
+
|Retorna um objeto do tipo [[Dev:APIs/JavaScript/latromi.formInstance|latromi.formInstance]], referente a um Formulário Dinâmico carregado na tela.
|Retorna um objeto do tipo '''formInstance''', referente a um Formulário Dinâmico carregado na tela.
 
 
|-
 
|-
 
|[[#setOnFormCreatedCallback|setOnFormCreatedCallback()]]
 
|[[#setOnFormCreatedCallback|setOnFormCreatedCallback()]]
|
 
 
|Callback disparado quando o Formulário for criado na página.
 
|Callback disparado quando o Formulário for criado na página.
 
|-
 
|-
 
|[[#setOnEventFiringCallback|setOnEventFiringCallback()]]
 
|[[#setOnEventFiringCallback|setOnEventFiringCallback()]]
|
 
 
|Callback disparado quando um evento for disparado.
 
|Callback disparado quando um evento for disparado.
 
|-
 
|-
 
|[[#setOnFieldValueChangedCallback|setOnFieldValueChangedCallback()]]
 
|[[#setOnFieldValueChangedCallback|setOnFieldValueChangedCallback()]]
|
 
 
|Callback disparado quando o valor de um campo for alterado.
 
|Callback disparado quando o valor de um campo for alterado.
 
|}
 
|}

Edição das 20h21min de 8 de julho de 2018

Gerenciador de Formulários Dinâmicos. Essa fornece os seguintes objetos no lado do cliente:

Métodos

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

getFormInstance()

Função que retorna uma instância de formInstance.

Parâmetro Tipo Descrição
upgradeCode * string Código de atualização do Formulário Dinâmico. Este parâmetro é opcional. Se for especificado, o formManager vai procurar um formulário que contenha esse código. Caso contrário, vai retornar o primeiro Formulário encontrado.

Exemplo:

function getFormInstance() {
   // Obtém a instância do formulário
   var form = latromi.formManager.getFormInstance();
   if (form) {
      console.log('Form com UpgradeCode ' + form.upgradeCode + ' encontrado!');
   }
}

setOnFormCreatedCallback()

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.

Parâmetro Tipo Descrição
callback function (arguments) Função de callback, esperando um parâmetro do tipo Object.

A função de callback informada deve esperar um parâmetro do tipo Object. Neste parâmetro estarão disponíveis as informações de contexto do evento, conforme especificadas abaixo:

CallbackArguments
Membro Tipo Descrição
form latromi.formInstance Instância do Formulários que foi criado.

setOnEventFiringCallback()

Parâmetro Tipo Descrição
callback function (arguments) Função de callback, esperando um parâmetro do tipo Object.

setOnFieldValueChangedCallback()

Parâmetro Tipo Descrição
callback function (arguments) Função de callback, esperando um parâmetro do tipo Object.