Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Krmarjenje po DOM-u: otroci, ime oznake, starš in sorojenci

Preberi ime oznake in se pomikaj med neposrednimi otroki, staršem in sosednjimi elementi. Razlikuj med zbirko, ki se sproti posodablja, in lastnostjo, ki lahko vrne `null`.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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

Teh pet lastnosti DOM-a je samo za branje. Bereš jih s piko, brez oklepajev za klic. Sodijo v API DOM-a, ne v ECMAScript 2024; izvajalno okolje brez DOM-a jih ne ponuja.

element.children je živa zbirka HTMLCollection neposrednih otrok, ki so elementi, v vrstnem redu DOM-a. Če takih otrok ni, je prazna. Tudi element.childNodes je živa zbirka, vendar vrste NodeList: vsebuje vsa neposredna otroška vozlišča, tudi besedilo in komentarje. Shranjena zbirka children se ob spremembah DOM-a posodablja. Array.from(element.children) v polje shrani trenutne sklice na elemente in njihov vrstni red, ne da bi elemente kloniral.

element.tagName vrne kvalificirano ime oznake kot niz, skupaj s predpono, če obstaja. Pri elementu v imenskem prostoru HTML v dokumentu HTML se črke ASCII pretvorijo v velike, kot pri "DIV". Sicer se velikost črk ohrani, tudi pri SVG v dokumentu HTML in XHTML, obdelanem kot XML. Za primerjave, ki upoštevajo imenski prostor, uporabi localName skupaj z namespaceURI.

element.parentElement izhaja iz vmesnika Node. Vrne neposrednega starša, če je ta element, ali null, če starša ni ali če ni element. Pri korenskem elementu dokumenta je na primer parentElement enak null, medtem ko parentNode vrne Document.

previousElementSibling in nextElementSibling vrneta najbližji element pred trenutnim oziroma za njim, pod istim staršem, ali null, če takega elementa ni. Preskočita besedilo in komentarje, v nasprotju s previousSibling in nextSibling, ki lahko vrneta tudi ta vozlišča. Pred branjem tagName preveri, ali je rezultat null, ali uporabi element.nextElementSibling?.tagName, ki vrne undefined, če naslednjega sorojenskega elementa ni.

Primeri

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

Rezultat

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

Shrani primer kot datoteko `.html`, odpri jo v brskalniku in preveri izpis v konzoli. Primer uporablja ločen dokument HTML in ne spremeni odprte strani. Presledek in komentar se štejeta v `childNodes`, ne pa v `children`; dodajanje elementa poveča le dolžino žive zbirke.

Povezane lekcije

  • JavaScript · Lekcija 34 · Srednja · Različica: 3

Viri