L'interfaccia HTMLCollection
rappresenta una raccolta generica (array-like object simile agli argomenti) di elementi (nell'ordine del documento) e offre metodi e proprietà per la selezione dall'elenco.
HTMLCollection
per ragioni storiche (prima del DOM moderno, le raccolte che implementano questa interfaccia potevano avere solo elementi HTML come elementi).Una HTMLCollection
nell'HTML DOM è attiva; viene aggiornata automaticamente quando viene modificato il documento sottostante.
Proprietà
HTMLCollection.length
Read only- Restituisce il numero di elementi nella raccolta.
Metodi
HTMLCollection.item()
- Restituisce il nodo specifico al dato
index
a base zero nella lista. Restituiscenull
seindex
non è compreso nell'intervallo HTMLCollection.namedItem()
- Restituisce il nodo specifico il cui ID o, come nome di fallback, corrisponde alla stringa specificata da
nome
. La corrispondenza per nome viene eseguita solo come ultima risorsa, solo in HTML, e solo se l'elemento di riferimento supporta l'attributoname
. Restituiscenull
se nessun nodo corrisponde con il nome specificato.
Utilizzo in JavaScript
HTMLCollection
espone anche i suoi membri direttamente come proprietà sia per nome che per indice. Gli ID HTML possono contenere :
e .
come caratteri validi, che richiederebbero l'uso della notazione della parentesi per l'accesso alla proprietà. Attualmente HTMLCollections non riconosce gli ID puramente numerici, il che causerebbe un conflitto con l'accesso in stile array, sebbene HTML5 li autorizzi.
Ad esempio, supponendo che esista un elemento <form>
nel documento e il suo id
sia "myForm"
:
var elem1, elem2;
// document.forms è una HTMLCollection
elem1 = document.forms[0];
elem2 = document.forms.item(0);
alert(elem1 === elem2); // ritorna: "true"
elem1 = document.forms.myForm;
elem2 = document.forms.namedItem("myForm");
alert(elem1 === elem2); // ritorna: "true"
elem1 = document.forms["named.item.with.periods"];
Specifiche
Specifica | Stato | Commento |
---|---|---|
DOM The definition of 'HTMLCollection' in that specification. |
Living Standard | |
Document Object Model (DOM) Level 2 HTML Specification The definition of 'HTMLCollection' in that specification. |
Obsolete | |
Document Object Model (DOM) Level 1 Specification The definition of 'HTMLCollection' in that specification. |
Obsolete | Definizione iniziale. |
Compatibilità con i browser
BCD tables only load in the browser