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 nullTě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
- Element: children property
- Element: tagName property
- Node: parentElement property
- Element: previousElementSibling property
- Element: nextElementSibling property
- Node: childNodes property
- HTMLCollection
- Element: localName property
- Element: namespaceURI property
- DOMImplementation: createHTMLDocument() method
- HTML Standard: Terminology
- ECMAScript 2024 Language Specification: Optional Chains