Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Węzły DOM: typ, wartość i węzły potomne

Odróżniaj węzły tekstowe od elementów, odczytuj wartość pojedynczego węzła i przechodź po bezpośrednich dzieciach z uwzględnieniem zmian listy.

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

Składnia

node.nodeType
node.nodeValue
node.nodeValue = text
node.childNodes
node.nodeType === Node.TEXT_NODE
node.nodeType === Node.ELEMENT_NODE

Właściwość node.nodeType jest tylko do odczytu i zwraca liczbę całkowitą określającą rodzaj węzła. Porównuj ją za pomocą === ze stałymi interfejsu Node: Node.TEXT_NODE (3) oznacza węzeł tekstowy, a Node.ELEMENT_NODE (1) — element. Element i zawarty w nim tekst to odrębne węzły. To API DOM platformy WWW, a nie część ECMAScript 2024; środowisko uruchomieniowe JavaScript nie musi udostępniać DOM.

node.nodeValue dotyczy samego węzła. W przypadku węzła tekstowego odczytuje jego tekst, a przypisanie ciągu znaków zastępuje ten tekst bez interpretowania go jako HTML. Komentarz również ma wartość tekstową. Dla elementu właściwość zwraca null, a przypisanie nic nie zmienia, nawet jeśli element zawiera tekst. Aby odczytać połączony tekst potomków elementu z pominięciem komentarzy i instrukcji przetwarzania, użyj element.textContent.

node.childNodes to właściwość tylko do odczytu, która udostępnia aktualizowaną na bieżąco listę NodeList bezpośrednich dzieci, a nie wszystkich potomków. Lista ma indeksy od zera i nie jest tablicą. Obejmuje elementy, tekst i komentarze. Wcięcia i nowe wiersze w HTML mogą tworzyć węzły tekstowe zawierające wyłącznie białe znaki, więc childNodes[0] nie musi być elementem. Jeżeli interesują Cię tylko bezpośrednie dzieci będące elementami, użyj element.children.

Zachowana w zmiennej lista nadal odzwierciedla dodawanie i usuwanie dzieci. Usunięcie węzła podczas przechodzenia do przodu może przesunąć indeksy i spowodować pominięcie następnego węzła. Jeśli potrzebujesz niezmiennego zestawu do iteracji, przed zmianami użyj Array.from(node.childNodes). Powstanie tablica odwołań do tych samych węzłów, a nie ich klonów.

Przykłady

{
  const { document, Node } = globalThis.document && globalThis.Node
    ? globalThis
    : createExampleDOM();

  const parent = document.createElement("div");
  const children = parent.childNodes;
  console.log(children.length);

  const text = document.createTextNode(" ");
  const span = document.createElement("span");
  span.appendChild(document.createTextNode("inside"));
  parent.appendChild(text);
  parent.appendChild(span);
  console.log(children.length);

  for (const child of children) {
    const type = child.nodeType;
    const kind = type === Node.TEXT_NODE ? "text" :
      type === Node.ELEMENT_NODE ? "element" : "other";
    console.log(JSON.stringify([kind, type, child.nodeValue]));
  }

  span.nodeValue = "ignored";
  console.log(span.textContent);
  text.nodeValue = "outside";
  console.log(text.nodeValue);

  // Plain Node.js has no DOM. This local model implements only the
  // element, text, and live-list operations used by this example.
  function createExampleDOM() {
    class ExampleNode {
      static TEXT_NODE = 3;
      static ELEMENT_NODE = 1;

      #type;
      #value;
      #children = [];
      #list;

      constructor(type, value = null) {
        this.#type = type;
        this.#value = value;
        const children = this.#children;
        this.#list = {
          get length() { return children.length; },
          [Symbol.iterator]() { return children[Symbol.iterator](); }
        };
      }

      get nodeType() { return this.#type; }
      get childNodes() { return this.#list; }
      get nodeValue() { return this.#value; }
      set nodeValue(value) {
        if (this.#type === ExampleNode.TEXT_NODE) {
          this.#value = value === null ? "" : String(value);
        }
      }

      get textContent() {
        if (this.#type === ExampleNode.TEXT_NODE) return this.#value;
        return this.#children.map(child => child.textContent).join("");
      }

      appendChild(child) {
        this.#children.push(child);
        return child;
      }
    }

    return {
      Node: ExampleNode,
      document: {
        createElement: () => new ExampleNode(ExampleNode.ELEMENT_NODE),
        createTextNode: value => new ExampleNode(ExampleNode.TEXT_NODE, String(value))
      }
    };
  }
}

Wynik

0
2
["text",3," "]
["element",1,null]
inside
outside

Uruchom kod w konsoli przeglądarki na stronie HTML. Zachowana lista zmienia długość z `0` na `2`, choć element nadrzędny nie jest dołączony do strony. Wiersz JSON dla węzła tekstowego pokazuje pojedynczą spację w cudzysłowie.

Powiązane lekcje

  • JavaScript · Lekcja 16 · Zaawansowany · Wersja: 4

Źródła