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

CKTIS / JavaScript

Pregledovanje in spreminjanje vozlišč DOM z vmesnikom `Node`

Preveri, ali vozlišče spada v poddrevo, preberi njegovega starša ali prvega otroka, vstavi vozlišče na določeno mesto in združi sosednja besedilna vozlišča.

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

Sintaksa

node.contains(otherNode)
node.normalize()
node.parentNode
node.firstChild
parent.insertBefore(newNode, referenceNode)
parent.insertBefore(newNode, null)

Node je vmesnik spletnega DOM-a, ne del standarda ECMAScript 2024. Te metode in lastnosti uporabljaš na objektih vozlišč. Primer v brskalniku uporablja vgrajeni DOM, v okolju Node.js pa poenostavljen model prikazanih elementov in besedilnih vozlišč.

node.contains(otherNode) vrne true, če je otherNode isto vozlišče ali njegov potomec na poljubni globini. Za null vrne false. Preverjanje ostane znotraj istega drevesa vozlišč: deluje tudi v odklopljenem poddrevesu in ne preide z gostitelja v njegovo senčno drevo.

parentNode in firstChild sta lastnosti samo za branje. Prva vrne neposrednega starša ali null; v nasprotju s parentElement lahko vrne tudi Document ali DocumentFragment. Druga vrne prvega neposrednega otroka ali null. Ta otrok je lahko komentar ali besedilno vozlišče z belimi znaki. Če želiš prvi element med neposrednimi otroki, uporabi firstElementChild.

parent.insertBefore(newNode, referenceNode) vstavi vozlišče pred podanega neposrednega otroka. Drugi argument podaj izrecno: null pomeni vstavljanje na konec. Z parent.firstChild torej vstaviš vozlišče na začetek, tudi če je starš prazen. Metoda obstoječe vozlišče premakne, ne kopira, in vrne newNode. Pri DocumentFragment premakne njegove otroke in vrne izpraznjeni fragment. Če referenčno vozlišče ni neposredni otrok, sproži NotFoundError; neveljavna hierarhija, na primer cikel, pa povzroči HierarchyRequestError.

node.normalize() spremeni obstoječe poddrevo: odstrani prazna običajna besedilna vozlišča in združi sosednja vozlišča te vrste v vrstnem redu besedila. Belih znakov ne odstrani in vrne undefined. Shranjena referenca na odstranjeno vozlišče še vedno kaže na isti objekt, vendar ta nima več starša. To ni normalizacija Unicode, ki jo izvaja String.prototype.normalize().

Primeri

{
  // Node.js has no document. This fallback models only the element and
  // text-node behavior used below; in a browser, use the native DOM.
  class ExampleNode {
    parentNode = null;
    childNodes = [];

    constructor(data = null) {
      this.data = data;
    }

    get firstChild() {
      return this.childNodes[0] ?? null;
    }

    contains(node) {
      for (let current = node; current !== null; current = current.parentNode) {
        if (current === this) return true;
      }
      return false;
    }

    #detach() {
      const parent = this.parentNode;
      if (parent !== null) {
        parent.childNodes.splice(parent.childNodes.indexOf(this), 1);
        this.parentNode = null;
      }
    }

    insertBefore(node, reference) {
      if (node === reference) return node;
      node.#detach();
      const index = reference === null
        ? this.childNodes.length
        : this.childNodes.indexOf(reference);
      this.childNodes.splice(index, 0, node);
      node.parentNode = this;
      return node;
    }

    normalize() {
      let previousText = null;
      for (const child of [...this.childNodes]) {
        if (child.data === null) {
          child.normalize();
          previousText = null;
        } else if (child.data === "") {
          child.#detach();
        } else if (previousText !== null) {
          previousText.data += child.data;
          child.#detach();
        } else {
          previousText = child;
        }
      }
    }
  }

  const doc = globalThis.document ?? {
    createElement: () => new ExampleNode(),
    createTextNode: (data) => new ExampleNode(data)
  };
  const root = doc.createElement("div");
  const a = doc.createTextNode("A");
  const b = doc.createTextNode("B");
  const empty = doc.createTextNode("");

  root.insertBefore(a, root.firstChild);
  root.insertBefore(b, null);
  root.insertBefore(empty, root.firstChild);
  console.log(JSON.stringify([
    root.contains(root), root.contains(null), root.contains(b),
    b.parentNode === root, root.firstChild === empty, root.childNodes.length
  ]));

  root.normalize();
  console.log(JSON.stringify([
    root.firstChild === a, root.firstChild.data, root.contains(b),
    b.parentNode === null, root.childNodes.length
  ]));
}

Rezultat

[true,false,true,true,true,3]
[true,"AB",false,true,1]

Zaženi kodo v konzoli brskalnika ali v okolju Node.js. `root` ostane zunaj dokumenta. Po normalizaciji `a` vsebuje `AB` in je edini otrok, medtem ko je `b` odklopljen.

Povezane lekcije

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

Viri