Formulários de documento HTML DOM
Exemplo
Número de elementos <form> no documento:
let num = document.forms.length;
Obtenha o id do primeiro elemento <form>:
let id = document.forms[0].id;
Obtenha o id do primeiro elemento <form>:
let id = document.forms.item(0).id;
Obtenha o conteúdo HTML do elemento <form> com id="myCarForm":
let html = document.forms.namedItem("myCarForm").innerHTML;
Mais exemplos abaixo.
Definição e uso
A forms
propriedade retorna uma coleção de todos os elementos <form> em um documento.
A forms
propriedade retorna um HTMLCollection .
A forms
propriedade é somente leitura.
Veja também:
A coleção de elementos de formulário
O tutorial de formulários HTML
Dica:
Use a coleção de elementos de formulários para retornar todos os elementos em um formulário.
HTMLCollection
Uma HTMLCollection é uma coleção de nós HTML.
Os nós em uma coleção podem ser acessados por números de índice. O índice começa em 0.
A propriedade length retorna o número de elementos na coleção.
Sintaxe
document.forms
Propriedades
Property | Description |
length | The number of elements in the collection. |
Métodos
Method | Description |
[index] | Returns the element with the specified index (starts at 0). Returns null if the index is out of range. |
item(index) | Returns the element with the specified index (starts at 0). Returns null if the index is out of range. |
namedItem(id) | Returns the element with the specified id. Returns null if the id does not exist. |
Valor de retorno
Modelo | Descrição |
Objeto | Um objeto HTMLCollection . Todos os elementos <form> no documento. Classificadas conforme aparecem no código-fonte |
Mais exemplos
Percorra todos os elementos <form> e produza o id de cada formulário:
const forms = document.forms;
let text = "";
for (let i = 0; i < forms.length; i++) {
text += forms[i].id + "<br>";
}
Usando a coleção form.elements para obter o valor de cada elemento no formulário:
const form = document.forms[0];
let text = "";
for (let i = 0; i < form.length; i++) {
text += forms.elements[i].value + "<br>";
}
Suporte ao navegador
document.forms
é um recurso DOM Nível 1 (1998).
É totalmente suportado em todos os navegadores:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | 9-11 | Yes | Yes | Yes | Yes |