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

CKTIS / JavaScript

Navigace v DOM: potomci, název značky, rodič a sourozenci

Zjisti název značky a přecházej mezi přímými potomky, rodičem a sousedními prvky. Rozlišuj, kdy se kolekce průběžně aktualizuje a kdy může vlastnost vrátit `null`.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

element.children                // HTMLCollection
element.tagName                 // string
element.parentElement           // Element or null
element.previousElementSibling  // Element or null
element.nextElementSibling      // Element or null

Těchto pět vlastností DOM je jen pro čtení. Přistupuj k nim tečkovou notací bez závorek pro volání. Patří k API DOM, nikoli k ECMAScriptu 2024; běhové prostředí bez DOM je neposkytuje.

element.children je živá kolekce HTMLCollection přímých potomků, kteří jsou prvky, v pořadí podle DOM. Pokud žádní takoví potomci nejsou, je prázdná. element.childNodes je také živá kolekce, ale typu NodeList: obsahuje všechny bezprostřední podřízené uzly včetně textu a komentářů. Uložená kolekce children se při změnách DOM aktualizuje. Array.from(element.children) zachytí aktuální odkazy na prvky a jejich pořadí v poli, aniž by prvky klonovalo.

element.tagName vrací kvalifikovaný název značky jako řetězec, včetně případné předpony. U prvku v oboru názvů HTML v dokumentu HTML se písmena ASCII převedou na velká, například "DIV". Jinak se velikost písmen zachovává, a to i u SVG v dokumentu HTML a u XHTML zpracovaného jako XML. Při porovnávání, které zohledňuje obor názvů, použij localName spolu s namespaceURI.

element.parentElement pochází z rozhraní Node. Vrací bezprostředního rodiče, pokud je prvkem, nebo null, pokud rodič neexistuje nebo není prvkem. Například u kořenového prvku dokumentu je parentElement rovno null, zatímco parentNode vrátí Document.

previousElementSibling a nextElementSibling vracejí nejbližší prvek před aktuálním prvkem nebo za ním se stejným rodičem, případně null, pokud takový prvek neexistuje. Přeskakují text a komentáře, na rozdíl od previousSibling a nextSibling, které tyto uzly mohou vrátit. Před čtením tagName ověř, že výsledek není null, nebo použij element.nextElementSibling?.tagName, což bez následujícího sourozeneckého prvku vrátí undefined.

Příklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DOM element traversal</title>
</head>
<body>
<script>
{
  const doc = document.implementation.createHTMLDocument();
  const box = doc.createElement('div');
  const first = doc.createElement('span');
  const second = doc.createElement('em');
  box.append(first, ' ', doc.createComment('gap'), second);

  const live = box.children;
  const snapshot = Array.from(live);
  console.log(JSON.stringify([live.length, box.childNodes.length, live[0].tagName]));
  console.log(JSON.stringify([
    first.parentElement?.tagName,
    first.nextElementSibling?.tagName,
    second.previousElementSibling?.tagName,
    first.previousElementSibling,
    second.nextElementSibling
  ]));

  box.append(doc.createElement('strong'));
  console.log(JSON.stringify([
    live.length, snapshot.length,
    doc.documentElement.parentElement,
    doc.documentElement.parentNode === doc
  ]));
}
</script>
</body>
</html>

Výsledek

[2,4,"SPAN"]
["DIV","EM","SPAN",null,null]
[3,2,null,true]

Ulož příklad jako soubor `.html`, otevři ho v prohlížeči a zkontroluj výstup v konzoli. Příklad používá samostatný dokument HTML a nemění otevřenou stránku. Textový uzel s jednou mezerou a komentář se počítají do `childNodes`, ale ne do `children`; přidáním prvku se zvětší pouze délka živé kolekce.

Související lekce

  • JavaScript · Lekce 34 · Středně pokročilá · Verze: 3

Zdroje