Mudanças entre as edições de "Desenvolvedor:APIs/JavaScript/latromi.formManager"
Desenvolvedor:APIs/JavaScript/latromi.formManager
(→Manipulando eventos do Formulário) |
(→Escutando eventos do Formulário) |
||
Linha 34: | Linha 34: | ||
== Exemplos == | == Exemplos == | ||
=== Escutando eventos do Formulário === | === Escutando eventos do Formulário === | ||
− | O exemplo a seguir mostra como criar um objeto para escutar os eventos | + | O exemplo a seguir mostra como criar um objeto para escutar os eventos do formulário. O código executa as seguintes ações: |
* Cria um objeto chamado '''MyForm''' | * Cria um objeto chamado '''MyForm''' | ||
− | * No objeto '''MyForm''' são adicionadas funções públicas e privadas para escutar os eventos do Formulário. A utilização de funções privadas para escutar os eventos não é obrigatória. O mesmo pode ser feiro diretamente | + | * No objeto '''MyForm''' são adicionadas funções públicas e privadas para escutar os eventos do Formulário. |
+ | *: ''OBS.: A utilização de funções privadas para escutar os eventos não é obrigatória. O mesmo pode ser feiro diretamente nas funções públicas.'' | ||
* Uma variável chamada '''myForm''' é declarada, e recebe uma nova instância do objeto '''MyForm'''. | * Uma variável chamada '''myForm''' é declarada, e recebe uma nova instância do objeto '''MyForm'''. | ||
− | * Em seguida, é configurada a escuta dos eventos | + | * Em seguida, é configurada a escuta dos eventos do formulário pelo objeto instanciado na variável '''myForm'''. |
<syntaxhighlight lang="JavaScript"> | <syntaxhighlight lang="JavaScript"> | ||
// Cria o objto MyForm | // Cria o objto MyForm |
Edição das 15h54min 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
Escutando eventos do Formulário
O exemplo a seguir mostra como criar um objeto para escutar os eventos do formulário. O código executa as seguintes ações:
- Cria um objeto chamado MyForm
- No objeto MyForm são adicionadas funções públicas e privadas para escutar os eventos do Formulário.
- OBS.: A utilização de funções privadas para escutar os eventos não é obrigatória. O mesmo pode ser feiro diretamente nas funções públicas.
- Uma variável chamada myForm é declarada, e recebe uma nova instância do objeto MyForm.
- Em seguida, é configurada a escuta dos eventos do formulário pelo objeto instanciado na variável myForm.
// Cria o objto MyForm 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 uma instância do objeto MyForm var myForm = new MyForm(); // Utiliza funções públicas do objeto MyForm como Callback para os eventos de Formulário. latromi.formManager.setOnFormCreatedCallback( myForm.onFormCreated ); latromi.formManager.setOnEventFiringCallback( myForm.onEventFiring ); latromi.formManager.setOnFieldValueChangedCallback( myForm.onFieldValueChanged );