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

De LATROMI Manuais
Desenvolvedor:APIs/JavaScript/latromi.formInstance/getFieldValue(string)
Ir para: navegação, pesquisa
(Exemplos)
 
Linha 18: Linha 18:
  
 
== Exemplos ==
 
== Exemplos ==
=== Preenchendo campos ===
+
=== Obtendo valor dos campos do Formulário ===
 
O Exemplo abaixo exibe no console do navegador o nome completo de uma pessoa, no formato brasileiro ou internacional. O código executa as seguintes ações:
 
O Exemplo abaixo exibe no console do navegador o nome completo de uma pessoa, no formato brasileiro ou internacional. O código executa as seguintes ações:
 
* Obtém uma instância do Formulário.
 
* Obtém uma instância do Formulário.

Edição atual tal como às 16h02min de 9 de julho de 2018

Função que retorna o valor de um campo. O tipo de dados retornado vai variar conforme o tipo de campo. Por exemplo, se for uma TextBox, o resultado será uma String, mas se for uma CheckBox o resultado será Boolean.

Memebro de: latromi.formInstance

Sintaxe

function getFieldValue(fieldName) { }

Parâmetros

fieldName
Tipo: String
Nome do campo a obter o valor.

Valor de Retorno

O tipo de dados do retorno varia conforme o tipo de campo.

Exemplos

Obtendo valor dos campos do Formulário

O Exemplo abaixo exibe no console do navegador o nome completo de uma pessoa, no formato brasileiro ou internacional. O código executa as seguintes ações:

  • Obtém uma instância do Formulário.
  • Obtém o valor das TextBoxes txtFirstName e txtLastName e da CheckBox chkIsInternational.
  • Se a CheckBox chkIsInternational estiver marcada, a mensagem será exibida em inglês no console do navegador, se não em português.
function logFullName() {
   // Obtém a instância do formulário
   var form = latromi.formManager.getFormInstance();
  
   // Obtém o valor dos campos
   var firstName = form.getFieldValue('txtFirstName'),
       lastName = form.getFieldValue('txtFirstName'),
       isInternational = form.getFieldValue('chkIsInternational');
   
   // Mostra uma mensagem em inglês no log se a 
   // CheckBox "chkIsInternational" estiver marcada
   if (isInternational  === true) {
      console.log('The full name is ' + lastName + ', ' + firstName);
   }
   else {
      console.log('O nome completo é ' + firstName + ' ' + lastName);
   }
}