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
(Sintaxe)
(Exemplos)
 
(7 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 1: Linha 1:
{{DISPLAYTITLE:getFieldValue(string)}}__NOTOC__
+
{{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.
 
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.
  
Linha 8: Linha 8:
 
function getFieldValue(fieldName) { }
 
function getFieldValue(fieldName) { }
 
</syntaxhighlight>
 
</syntaxhighlight>
 
=== Valor de Retorno ===
 
O tipo de dados do retorno varia conforme o tipo de campo.
 
  
 
=== Parâmetros ===
 
=== Parâmetros ===
: fieldName
+
: ''fieldName''
 +
:: Tipo: String
 
:: Nome do campo a obter o valor.
 
:: Nome do campo a obter o valor.
 +
 +
=== Valor de Retorno ===
 +
: O tipo de dados do retorno varia conforme o tipo de campo.
  
 
== Exemplos ==
 
== Exemplos ==
 
+
=== Obtendo valor dos campos do Formulário ===
O Exemplo abaixo exibe no Console do navegador o nome da tag do elemento retornado pela função ''getElement()'':
+
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">
 
<syntaxhighlight lang="JavaScript">
Linha 30: Linha 34:
 
       isInternational = form.getFieldValue('chkIsInternational');
 
       isInternational = form.getFieldValue('chkIsInternational');
 
    
 
    
   // Mostra uma mensagem em inglês no log se se a  
+
   // Mostra uma mensagem em inglês no log se a  
 
   // CheckBox "chkIsInternational" estiver marcada
 
   // CheckBox "chkIsInternational" estiver marcada
 
   if (isInternational  === true) {
 
   if (isInternational  === true) {

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);
   }
}