Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Nawigacja po DOM: dzieci, nazwa znacznika, rodzic i rodzeństwo

Odczytuj nazwę znacznika i przechodź między bezpośrednimi dziećmi, rodzicem i sąsiednimi elementami. Sprawdź, kiedy wynik jest aktualizowaną kolekcją, a kiedy może mieć wartość `null`.

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

Składnia

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

Tych pięć właściwości DOM jest tylko do odczytu: używaj zapisu z kropką, bez nawiasów wywołania. Należą do API DOM, nie do ECMAScript 2024; środowisko bez DOM ich nie udostępnia.

element.children to żywa kolekcja HTMLCollection zawierająca tylko bezpośrednie dzieci będące elementami, w kolejności DOM. Bez takich dzieci kolekcja jest pusta. element.childNodes to również żywa kolekcja, ale typu NodeList, obejmująca wszystkie bezpośrednie węzły potomne, w tym tekst i komentarze. Po zmianie DOM zawartość wcześniej zapisanej kolekcji children się aktualizuje. Array.from(element.children) zapisuje w tablicy aktualny zestaw i kolejność odwołań do elementów, nie kopiuje samych elementów.

element.tagName zwraca kwalifikowaną nazwę znacznika jako ciąg znaków, z prefiksem, jeśli występuje. Dla elementu w przestrzeni nazw HTML należącego do dokumentu HTML litery ASCII są zamieniane na wielkie, np. "DIV". W pozostałych przypadkach wielkość liter zostaje zachowana, także dla SVG w dokumencie HTML i dla XHTML przetwarzanego jako XML. Do porównań uwzględniających przestrzeń nazw używaj localName razem z namespaceURI.

element.parentElement to właściwość interfejsu Node. Zwraca bezpośredniego rodzica, jeśli jest on elementem, lub null, jeśli rodzica nie ma albo nie jest elementem. Na przykład dla korzenia dokumentu parentElement zwraca null, lecz parentNode zwraca Document.

previousElementSibling i nextElementSibling zwracają odpowiednio najbliższy poprzedni lub następny element mający tego samego rodzica, a przy braku takiego elementu zwracają null. Pomijają tekst i komentarze, w odróżnieniu od previousSibling i nextSibling, które mogą zwrócić te węzły. Przed odczytem tagName sprawdź, czy wynik nie jest null, albo użyj element.nextElementSibling?.tagName, co przy braku sąsiada daje undefined.

Przykłady

<!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>

Wynik

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

Zapisz przykład jako plik `.html`, otwórz go w przeglądarce i sprawdź wynik w konsoli. Przykład nie modyfikuje otwartej strony: używa osobnego dokumentu HTML. Odstęp i komentarz liczą się w `childNodes`, lecz nie w `children`; po dodaniu elementu rośnie tylko długość żywej kolekcji.

Powiązane lekcje

  • JavaScript · Lekcja 34 · Średniozaawansowany · Wersja: 3

Źródła