This translation is incomplete. Please help translate this article from English.
Interfața HTMLCollection reprezintă o colecție generică (obiect array-like) de elemente (în ordinea din document) și oferă metode și proprietăți pentru a selecta din listă.
HTMLCollection din motive istorice (înainte de DOM4, colecțiile care implementau această interfață puteau conține doar elemente HTML).Un HTMLCollection în HTML DOM este live; colecția este actualizată automat atunci când documentul este modificat.
Proprietăți
HTMLCollection.lengthRead only- Returnează numărul de elemente din colecție.
Metode
HTMLCollection.item()- Returnează nodul aflat pe poziția specificată (0-bazat) în listă. Returnează null dacă poziția este în afara intervalului.
HTMLCollection.namedItem()- Returnează nodul al cărui ID sau, ca și variantă de rezervă,
namecorespunde string-ului specificat ca și parametru. Potrivirea dupănameeste folosită doar ca ultimă soluție, doar în HTML, și doar dacă elementul referit suportă atributulname. Returnează null dacă niciun nod nu poate fi găsit plecând de la parametrul specificat.
Utilizare în JavaScript
HTMLCollection își expune de asemenea membrii în mod direct ca și proprietăți prin nume și prin index. ID-urile din HTML pot conține : și . ca și caractere valide, ceea ce face necesară utilizarea parantezelor pătrate pentru a accesa proprietățile. Momentan collecțiile de tip HTMLCollection nu recunosc ID-urile pur numerice, care ar intra în conflict cu sintaxa de tip array, deși HTML5 permite ca acestea să existe.
De exemplu, asumând ca există un element de tip <form> în document și id-ul său este "myForm":
var elem1, elem2;
// document.forms este un HTMLCollection
elem1 = document.forms[0];
elem2 = document.forms.item(0);
alert(elem1 === elem2); // afișază: "true"
elem1 = document.forms.myForm;
elem2 = document.forms.namedItem("myForm");
alert(elem1 === elem2); // afișază: "true"
elem1 = document.forms["named.item.with.periods"];
Compatibilitatea între navigatoare
Diferite navigatoare se comportă diferit când există mai mult de un element care se potrivește string-ului folosit ca index (sau ca argument pentru namedItem). Firefox 8 se comportă conform cu specificațiile din DOM 2 și DOM4, returnând primul element care se potrivește. Navigatoarele WebKit și Internet Explorer în acest caz returnează un alt HTMLCollection iar Opera returnează un NodeList conținând elementele care se potrivesc.