MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

HTMLCollection

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ă.

Notă: Această interfață este numită 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.length Read 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ă, name corespunde string-ului specificat ca și parametru. Potrivirea după name este folosită doar ca ultimă soluție, doar în HTML, și doar dacă elementul referit suportă atributul name. 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.

Specificații

Vezi de asemenea

Document Tags and Contributors

 Contributors to this page: me-stefan-baiu
 Last updated by: me-stefan-baiu,