CKTIS / JavaScript
HTMLCollection.length — število elementov v zbirki
HTMLCollection.length vrne trenutno število elementov v zbirki DOM. Lastnost je samo za branje, njena vrednost pa se samodejno posodobi, ko se spremeni vsebina žive zbirke.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
collection.lengthHTMLCollection.length je lastnost samo za branje, ki vrne nenegativno celo število: število elementov v zbirki. Beremo jo kot collection.length, brez oklepajev za klic. Prazna zbirka ima dolžino 0. Indeksi se začnejo pri 0, zato je zadnji indeks neprazne zbirke collection.length - 1.
HTMLCollection je živa: spremembe v DOM, ki vplivajo na njeno vsebino, samodejno posodobijo zbirko in njeno lastnost length. V primeru container.children vključuje samo neposredne otroke, ki so elementi. Dodajanje besedilnega vozlišča števila ne poveča, dodajanje elementa pa ga. Isti sklic items odraža tudi poznejšo odstranitev elementa.
HTMLCollection ne obravnavajte kot polje: z dodelitvijo vrednosti lastnosti length zbirke ne morete skrajšati. Namesto tega spremenite ustrezne elemente DOM. Odstranjevanje elementov med iteracijo lahko premakne indekse in povzroči izpuščanje vnosov. Če načrtujete takšne spremembe, iterirajte po kopiji, ustvarjeni z Array.from(collection).
To je API DOM v brskalniku, ne funkcija določene izdaje ECMAScript. MDN navaja, da je ta lastnost široko podprta v brskalnikih od julija 2015. Prisotnost Node 24 v repozitoriju ne dokazuje, da je DOM na voljo ali da brskalniki podpirajo ta API.
Primeri
(() => {
const container = document.createElement("div");
const items = container.children;
console.log(items.length);
container.appendChild(document.createTextNode("text"));
console.log(items.length);
const child = document.createElement("span");
container.appendChild(child);
console.log(items.length);
container.removeChild(child);
console.log(items.length);
})();Rezultat
0 0 1 0
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.