Exibir código-fonte para Desenvolvedor:APIs/JavaScript/latromi.formInstance/getFieldValue(string)

{{DISPLAYTITLE:Método getFieldValue(string)}}__NOTOC__
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:''' [[DEV:APIs/JavaScript/latromi.formInstance|latromi.formInstance]]

== Sintaxe ==
<syntaxhighlight lang="JavaScript">
function getFieldValue(fieldName) { }
</syntaxhighlight>

=== 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.

<syntaxhighlight lang="JavaScript">
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);
   }
}
</syntaxhighlight>