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
Linha 52: Linha 52:
 
   console.log('Formulário com ID ' + form.id +  
 
   console.log('Formulário com ID ' + form.id +  
 
               ' e Código de Atualização ' + form.upgradeCode);
 
               ' e Código de Atualização ' + form.upgradeCode);
}
 
</syntaxhighlight>
 
 
== <span id="setFieldValue"></span>setFieldValue() ==
 
Função que '''atribui valor a um campo'''. O valor especificado deve variar conforme o tipo de campo. Por exemplo, se form uma ''TextBox'' deve ser passado um valor do tipo ''String'', mas se for uma ''CheckBox'', deve ser um valor do tipo ''Booelan''.
 
 
{|class="wikitable apidoctable"
 
! Parâmetro
 
! Tipo
 
! Descrição
 
|----------------------------------
 
| fieldName
 
| String
 
| Nome do campo que reberá o valor.
 
|-
 
| value
 
| Any
 
| Valor a ser atribuído ao campo. O tipo de dados varia conforme o tipo de campo.
 
|}
 
 
Exemplo:
 
 
<syntaxhighlight lang="JavaScript">
 
function populateFields() {
 
  // Obtém a instância do formulário
 
  var form = latromi.formManager.getFormInstance();
 
 
 
  // Preenche os campos
 
  form.setFieldValue('txtFirstName', 'Bob').
 
  form.setFieldValue('txtLastName', 'Dylan').
 
  form.setFieldValue('chkIsInternational', true);
 
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>

Edição das 17h03min de 9 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:

Propriedades
Nome Retorno Descrição
id Number Obtém o ID do Formulário Dinâmico.
upgradeCode String Obtém o Código de Atualização (Chave Única) do Formulário Dinâmico.
Métodos
Nome Retorno Descrição
getElement() Element Obtém o Elemento HTML que envolve o Formulário Dinâmico.
getFieldValue(string) Any Obtém o valor atual de um campo.
setFieldValue(string, any) Any Atribui valor a um campo.

id

Propriedade que retorna o ID do cadastro do Formulário Dinâmico. Este ID é numérico, e não deve ser confundido com o ID do Elemento HTML.

upgradeCode

Propriedade que retorna o Código de Atualização do Formulário Dinâmico.

Exemplo:

function logProperties() {
   // Obtém a instância do formulário
   var form = latromi.formManager.getFormInstance();
   
   // Mostra no log o valor das propriedades
   console.log('Formulário com ID ' + form.id + 
               ' e Código de Atualização ' + form.upgradeCode);
}

Ver Também

latromi.formManager