Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

HTMLCollection.length — počet prvků v kolekci

HTMLCollection.length vrací aktuální počet prvků v kolekci DOM. Je pouze pro čtení a její hodnota se automaticky aktualizuje, když se změní obsah živé kolekce.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

collection.length

HTMLCollection.length je vlastnost pouze pro čtení, která vrací nezáporné celé číslo: počet prvků v kolekci. Čte se jako collection.length, bez závorek pro volání. Prázdná kolekce má délku 0. Indexy začínají na 0, takže poslední index neprázdné kolekce je collection.length - 1.

HTMLCollection je živá: změny v DOM, které ovlivňují její obsah, automaticky aktualizují kolekci i její vlastnost length. V příkladu container.children zahrnuje pouze přímé potomky, které jsou prvky. Přidání textového uzlu počet nezvýší, přidání prvku ano. Stejný odkaz items odráží také následné odebrání prvku.

Nepovažujte HTMLCollection za pole: přiřazením hodnoty do length ji nelze zkrátit. Místo toho změňte příslušné prvky DOM. Odebrání prvků během iterace může posunout indexy a způsobit přeskočení položek. Pokud takové změny plánujete, iterujte přes kopii vytvořenou pomocí Array.from(collection).

Jde o API DOM v prohlížeči, nikoli o funkci konkrétní edice ECMAScriptu. MDN uvádí, že tato vlastnost je široce dostupná v prohlížečích od července 2015. Přítomnost Node 24 v repozitáři nedokládá dostupnost DOM ani podporu tohoto API v prohlížečích.

Pří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ýsledek

0
0
1
0

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje