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

De LATROMI Manuais
Desenvolvedor:APIs/JavaScript/latromi.formInstance
Ir para: navegação, pesquisa
(Criou página com '{{DISPLAYTITLE:latromi.formInstance}} Conjunto de funções e propriedades para interação com o Formulário Dinâmico. Essa API fornece os seguintes objetos no lado do clien...')
 
Linha 1: Linha 1:
 
{{DISPLAYTITLE:latromi.formInstance}}
 
{{DISPLAYTITLE:latromi.formInstance}}
−
Conjunto de funções e propriedades para interação com o Formulário Dinâmico. Essa API fornece os seguintes objetos no lado do cliente:
+
Conjunto de funções e propriedades para interação com o Formulário Dinâmico. A instância desse objeto deve ser obtido através da API [[Dev:APIs/JavaScript/latromi.formManager|formManager]]. Essa API fornece os seguintes objetos no lado do cliente:
  
 
{|class="wikitable apidoctable"
 
{|class="wikitable apidoctable"
Linha 7: Linha 7:
 
! Descrição
 
! Descrição
 
|----------------------------------
 
|----------------------------------
−
|[[#getFormInstance|getFormInstance()]]
+
|id
−
|[[Dev:APIs/JavaScript/latromi.formInstance|latromi.formInstance]]
+
|Number
−
|Retorna um objeto do tipo '''formInstance''', referente a um Formulário Dinâmico carregado na tela.
+
|Obtém o ID do Formulário Dinâmico (não é o ID do Elemento HTML).
 +
|-
 +
|upgradeCode
 +
|String
 +
|Obtém o Código de Atualização (Chave Única) do Formulário Dinâmico.
 +
|-
 +
|[[#getElement|getElement()]]
 +
|Element
 +
|Obtém o Elemento HTML que envolve o Formulário Dinâmico.
 +
|-
 +
|getFieldValue()
 +
|Any
 +
|Obtém o valor atual de um campo.
 +
|-
 +
|setFieldValue()
 +
|Any
 +
|Atribui valor a um campo.
 
|}
 
|}
 +
 +
= <span id="getElement"></span>getElement() =
 +
Função que retorna o Elemento HTML que envolve o Formulário Dinâmico. O comum é que seja retornado uma DIV, com a classe CSS ''DynamicForm''.
 +
 +
;Exemplo
 +
<syntaxhighlight lang="JavaScript">
 +
function getElement() {
 +
  var form = latromi.formManager.getFormInstance();
 +
  var element = form.getElement();
 +
  if (element) {
 +
      console.log('Elemento do tipo  ' + element.tagName + ' encontrado!');
 +
  }
 +
}
 +
</syntaxhighlight>

Edição das 03h51min de 7 de julho de 2018

Conjunto de funções e propriedades para interação com o Formulário Dinâmico. A instância desse objeto deve ser obtido através da API formManager. Essa API fornece os seguintes objetos no lado do cliente:

Funções / Propriedades Tipo Descrição
id Number Obtém o ID do Formulário Dinâmico (não é o ID do Elemento HTML).
upgradeCode String Obtém o Código de Atualização (Chave Única) do Formulário Dinâmico.
getElement() Element Obtém o Elemento HTML que envolve o Formulário Dinâmico.
getFieldValue() Any Obtém o valor atual de um campo.
setFieldValue() Any Atribui valor a um campo.

getElement()

Função que retorna o Elemento HTML que envolve o Formulário Dinâmico. O comum é que seja retornado uma DIV, com a classe CSS DynamicForm.

Exemplo
function getElement() {
   var form = latromi.formManager.getFormInstance();
   var element = form.getElement();
   if (element) {
      console.log('Elemento do tipo  ' + element.tagName + ' encontrado!');
   }
}
Disponível em "http://docs.latromi.com.br/index.php?title=Desenvolvedor:APIs/JavaScript/latromi.formInstance&oldid=1626"