База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Навигация в DOM: деца, име на таг, родител и съседни елементи

Прочети името на тага и се придвижвай между преките деца, родителя и съседните елементи. Различавай кога колекцията се обновява и кога дадено свойство може да върне `null`.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

Тези пет свойства на DOM са само за четене. Използвай точка, без скоби за извикване. Те принадлежат на DOM API, а не на ECMAScript 2024; среда без DOM не ги предоставя.

element.children е жива колекция HTMLCollection само от преките деца, които са елементи, в реда им в DOM. Ако няма такива деца, колекцията е празна. element.childNodes също е жива колекция, но от тип NodeList, която съдържа всички преки дъщерни възли, включително текст и коментари. Запазена колекция children се обновява при промени в DOM. Array.from(element.children) записва текущите препратки към елементите и реда им в масив, без да клонира самите елементи.

element.tagName връща квалифицираното име на тага като низ, с префикс, ако има такъв. За елемент в пространството от имена HTML в HTML документ ASCII буквите се преобразуват в главни, както в "DIV". В останалите случаи главните и малките букви се запазват, включително за SVG в HTML документ и за XHTML, обработен като XML. Когато при сравнение има значение пространството от имена, използвай localName заедно с namespaceURI.

element.parentElement идва от интерфейса Node. Връща прекия родител, ако е елемент, или null, ако няма родител или родителят не е елемент. Например за кореновия елемент на документ parentElement е null, а parentNode връща Document.

previousElementSibling и nextElementSibling връщат най-близкия елемент съответно преди или след текущия в рамките на същия родител, или null, ако няма такъв. Те пропускат текста и коментарите, за разлика от previousSibling и nextSibling, които могат да върнат тези възли. Провери за null, преди да прочетеш tagName, или използвай element.nextElementSibling?.tagName, което дава undefined, ако няма следващ елемент със същия родител.

Примери

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

Резултат

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

Запази примера като файл с разширение `.html`, отвори го в браузър и провери изхода в конзолата. Примерът използва отделен HTML документ и не променя отворената страница. Интервалът и коментарът се броят в `childNodes`, но не и в `children`; добавянето на елемент увеличава само дължината на живата колекция.

Свързани уроци

  • JavaScript · Урок 34 · Средно · Версия: 3

Източници