HTMLCollection

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julho de 2015⁩.

A interfaceHTMLCollection representa uma coleção genérica (objeto array) de elementos (na ordem em que aparecem no documento) e oferece métodos e propriedades para selecioná-los da lista.

Nota:Esta interface é chamadaHTMLCollection por razões históricas (antes do DOM4, coleções implementadas por esta interface somente podiam ter elementos HTML).

Uma coleçãoHTMLCollection de um HTML DOM está linkada com o documento; ela será automaticamente atualizada quando o documento for modificado.

Propriedades

HTMLCollection.lengthSomente leitura: Retorna o número de itens da coleção.

Métodos

HTMLCollection.item(): Retorna um nó especificado porindex da lista. o primeiro index da lista é 0. Retornanull seindex não existir na lista.
HTMLCollection.namedItem(): Retorna o nó especificado pelo ID ou, caso não tenha ID, o item cuja propriedadename seja igual à pesquisa. Pesquisa porname só é feita em último caso, somente em HTML, e somente se os elementos referenciados suportarem o atributoname. Retornanull se nenhum nó corresponder ao nome pesquisado.

HTMLCollection expõe seus membros diretamente como propriedades, tanto por nome quanto por índice. IDs HTML podem conter : e . como caracteres válidos, o que fará necessária a utilização de colchetes para acessar as propriedades. Atualmente HTMLCollection não reconhece IDs puramente numéricos, o que pode causar conflitos com acesso em formato array, apesar do HTML5 os permitir.

Por exemplo, assumindo que há um elemento<form> no documento e seuid é"myForm":

var elem1, elem2;// document.forms é um HTMLCollectionelem1 = document.forms[0];elem2 = document.forms.item(0);alert(elem1 === elem2); // exibe: "true"elem1 = document.forms.myForm;elem2 = document.forms.namedItem("myForm");alert(elem1 === elem2); // exibe: "true"elem1 = document.forms["named.item.with.periods"];

Compatibilidade com navegadores

Diferentes browsers se comportam de maneira diferente quando um os mais elementos são pesquisados pela string utilizada como índice (ou o argumento namedItem). Firefox 8 se comporta como especificado no DOM 2 e no DOM 4, retornando o primeiro elemento encontrado. WebKit browsers e o Internet Explorer, neste caso, retornam outro HTMLCollection e o Opera retorna umNodeList com todos os elementos encontrados.