Coleção de elementos de formulário
Exemplo
Descubra quantos elementos existem em um elemento <form> especificado:
var x = document.getElementById("myForm").elements.length;
O resultado de x será:
3
Mais exemplos de "Experimente você mesmo" abaixo.
Definição e uso
A coleção de elementos retorna uma coleção de todos os elementos em um formulário.
Observação: os elementos da coleção são classificados conforme aparecem no código-fonte.
Nota: A coleção de elementos retorna todos os elementos dentro do elemento <form>, não todos os elementos <form> no documento. Para obter todos os elementos <form> no documento, use a coleção document.forms .
Suporte ao navegador
Collection | |||||
---|---|---|---|---|---|
elements | Yes | Yes | Yes | Yes | Yes |
Sintaxe
formObject.elements
Propriedades
Property | Description |
---|---|
length | Returns the number of elements in the <form> element. Note: This property is read-only |
Métodos
Method | Description |
---|---|
[index] | Returns the element in <form> with the specified index (starts at 0). Note: Returns null if the index number is out of range |
item(index) | Returns the element in <form> with the specified index (starts at 0). Note: Returns null if the index number is out of range |
namedItem(id) | Returns the element in <form> with the specified id. Note: Returns null if the id does not exist |
Detalhes técnicos
Versão DOM: | Objeto de documento de nível 2 principal |
---|---|
Valor de retorno: | Um objeto HTMLFormsControlCollection, representando todos os elementos em um elemento <form>. Os elementos da coleção são classificados conforme aparecem no código-fonte |
Mais exemplos
Exemplo
[ índice ]
Obtenha o valor do primeiro elemento (índice 0) em um formulário:
var x = document.getElementById("myForm").elements[0].value;
O resultado de x será:
Donald
Exemplo
item ( índice )
Obtenha o valor do primeiro elemento (índice 0) em um formulário:
var x = document.getElementById("myForm").elements.item(0).value;
O resultado de x será:
Donald
Exemplo
nomeadoItem( id )
Obtenha o valor do elemento com name="fname" em um formulário:
var x = document.getElementById("myForm").elements.namedItem("fname").value;
O resultado de x será:
Donald
Exemplo
Percorra todos os elementos em um formulário e produza o valor de cada elemento:
var x = document.getElementById("myForm");
var txt = "";
var i;
for (i = 0; i < x.length; i++)
{
txt = txt + x.elements[i].value + "<br>";
}
document.getElementById("demo").innerHTML = txt;
O resultado do txt será:
Donald
Duck
Submit
❮ Objeto de formulário