CKTIS / JavaScript
HTMLCollection.length — počet prvkov v kolekcii
HTMLCollection.length vracia aktuálny počet prvkov v kolekcii DOM. Je iba na čítanie a jej hodnota sa automaticky aktualizuje, keď sa zmení obsah živej kolekcie.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
collection.lengthHTMLCollection.length je vlastnosť iba na čítanie, ktorá vracia nezáporné celé číslo: počet prvkov v kolekcii. Číta sa ako collection.length, bez zátvoriek na volanie. Prázdna kolekcia má dĺžku 0. Indexy sa začínajú od 0, takže posledný index neprázdnej kolekcie je collection.length - 1.
HTMLCollection je živá: zmeny v DOM, ktoré ovplyvňujú jej obsah, automaticky aktualizujú kolekciu aj jej vlastnosť length. V príklade container.children zahŕňa iba priamych potomkov, ktorí sú prvkami. Pridanie textového uzla počet nezvýši, pridanie prvku áno. Rovnaký odkaz items odráža aj následné odstránenie prvku.
Nepovažujte HTMLCollection za pole: priradením hodnoty do length ju nemožno skrátiť. Namiesto toho zmeňte príslušné prvky DOM. Odstraňovanie prvkov počas iterácie môže posunúť indexy a spôsobiť preskočenie položiek. Ak takéto zmeny plánujete, iterujte cez kópiu vytvorenú pomocou Array.from(collection).
Ide o API DOM v prehliadači, nie o funkciu konkrétnej edície ECMAScriptu. MDN uvádza, že táto vlastnosť je široko dostupná v prehliadačoch od júla 2015. Prítomnosť Node 24 v repozitári nedokazuje dostupnosť DOM ani podporu tohto API v prehliadačoch.
Príklady
(() => {
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);
})();Výsledok
0 0 1 0
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.