Objeto HTMLCollection XML DOM

Objeto HTMLCollection

A coleção HTMLCollection é uma interface que representa uma coleção de elementos HTML, fornecendo métodos e propriedades para percorrer a lista.

A coleção HTMLCollection no HTML DOM é 'ativa'; se o documento básico mudar, essas mudanças serão exibidas imediatamente em todos os objetos coleção HTMLCollection.

Cada item a seguir (e seus atributos especificados) retorna uma coleção HTMLCollection:

  • Document (images, applets, links, forms, anchors)
  • form (elements)
  • map (areas)
  • select (options)
  • table (rows, tBodies)
  • tableSection (rows)
  • row (cells)

Muitas propriedades da interface HTMLDocument são coleções HTMLCollection, fornecendo uma maneira conveniente de acessar elementos do documento como formulários, imagens e links.form.elements e select.options também são coleções HTMLCollection. A coleção HTML também oferece a capacidade de Table as linhas TableRow um método conveniente para acessar cada célula.

Como já mencionado, a coleção HTMLCollection é uma coleção de elementos HTML com métodos, que pode ser usada para obter elementos com base na posição dos elementos no documento ou em seus atributos id e name. No JavaScript, o comportamento da coleção HTMLCollection é semelhante a um array apenas de leitura, e pode-se usar o colchete do JavaScript para indexar uma coleção HTMLCollection por número ou nome, sem precisar chamar Método item()e Método namedItem().

A coleção HTMLCollection é apenas de leitura e não pode ter novos elementos adicionados, mesmo usando a sintaxe de array do JavaScript.

A coleção HTMLCollection e Objeto NodeListMuito semelhantes, mas o primeiro pode ser acessado tanto por nome quanto por índice numérico.

Atributos da coleção HTMLCollection

Atributo Descrição
cssRules Propriedade apenas de leitura, que retorna um inteiro que indica o comprimento da lista (ou seja, o número de elementos na coleção).

Métodos da coleção HTMLCollection

Método Descrição
item() Retorna o elemento (nó) na posição especificada na coleção.
namedItem() Retorna o elemento (nó) com a propriedade name ou id com o valor especificado na coleção.

Exemplo

var c = document.forms;		//Este é um objeto HTMLCollection do elemento form
var firstform = c[0];		//Pode ser usado como array numérico
var lastform = c[c.length-1];	//A propriedade length retorna o número de elementos
var address = c["address"];		//Pode ser usado como array associativo
var address = c.address;		//JavaScript permite essa representação

Páginas relacionadas

Manual de referência XML DOM:Objeto HTMLDocument

Manual de referência XML DOM:Objeto NodeList

Manual de referência:Manual de referência HTML DOM