Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

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

Zdroje