HTMLCollection

Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.

La interface HTMLCollection representa una colección genérica (objeto tipo arreglo) de elementos (en orden de documento) y ofrece métodos y propiedades para seleccionar de la lista.

Nota: Esta interface es llamada HTMLCollection por razones históricas (antes de DOM4. las colecciones que implementaban esta interface sólo podian tener elementos HTML como sus items).

Una HTMLCollection en el DOM HTML DOM está viva; se actualiza automáticamente cuando el documento subyacente cambia.

Propiedades

HTMLCollection.length Read only
Devuelve el numero de items en la colección.

Métodos

HTMLCollection.item()
Devuelve el nodo específicado como índice en base cero dentro de la lista. Devuelve null si el índice está fuera de rango.
HTMLCollection.namedItem()
Devuelve el nodo específico cuyo ID o, en último caso, cuyo nombre coincide con la cadena especificada por name. La coincidencia por nombre sólo se hace como último recurso, sólo en HTML, y sólo si el elemento referenciado soporta el atributo name. Devuelve null si no existe ningún nodo con el nombre indicado.

Uso en JavaScript

HTMLCollection también expone a sus miembros directamente como propiedades tanto por name como por index. Los IDS de HTML deben contener : . como caracteres válidos, los cuales necesitan del uso de corchetes para acceder a sus propiedades. Actualmente las HTMLCollections no reconocen los IDS puramente numéricos, lo que causaría conflicto con el acceso al estilo array, aunque HTML5 sí permite estos.

Por ejemplo, suponiendo que hay un elemento <form> en el documento y que su id es "myForm":

var elem1, elem2;

// document.forms is an HTMLCollection

elem1 = document.forms[0];
elem2 = document.forms.item(0);

alert(elem1 === elem2); // shows: "true"

elem1 = document.forms.myForm;
elem2 = document.forms.namedItem("myForm");

alert(elem1 === elem2); // shows: "true"

elem1 = document.forms["named.item.with.periods"];

Compatibilidad de los navegadores

Los diferentes navegadores se comportan de manera diferente cuando hay más de un elemento que coincide con la cadena usada como índice (o como argumento namedItem). Firefox 8 se comporta como se especifica en DOM 2 y DOM4, devolviendo el primer elemento que coincide. Los navegadores WebKit y Internet Explorer en este caso devuelve otra HTMLCollection y Opera devuelve una NodeList con todos los elementos coincidentes.

Especificación

Vea también

Etiquetas y colaboradores del documento

Etiquetas: 
 Colaboradores en esta página: diego_bardelas, kromsoft, djrm
 Última actualización por: diego_bardelas,