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

CKTIS / JavaScript

DOM възли: тип, стойност и дъщерни възли

Различавайте текстовите възли от елементите, четете стойността на отделен възел и отчитайте промените в списъка при обхождане на преките му дъщерни възли.

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

Синтаксис

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

node.nodeType е свойство само за четене, което връща цяло число за типа на възела. Сравнете го чрез === с константите на интерфейса Node: Node.TEXT_NODE (3) означава текстов възел, а Node.ELEMENT_NODE (1) — елемент. Елементът и текстът в него са отделни възли. Тези DOM интерфейси са част от уеб платформата, а не от ECMAScript 2024; средата за изпълнение на JavaScript не е длъжна да предоставя DOM.

node.nodeValue се отнася до самия възел. При текстов възел свойството връща текста му, а присвояването на низ заменя текста, без низът да се интерпретира като HTML. Коментарът също има стойност от тип низ. При елемент свойството връща null, а присвояването няма ефект дори ако елементът съдържа текст. За да прочетете обединения текст на наследниците на елемента без коментарите и инструкциите за обработка, използвайте element.textContent.

Свойството node.childNodes е само за четене и връща динамичен списък NodeList на преките дъщерни възли, а не на всички наследници. Индексите започват от нула и списъкът не е масив. Той включва елементи, текстови възли и коментари. Отстъпите и новите редове в HTML могат да създадат текстови възли, съдържащи само празни знаци, затова childNodes[0] не е непременно елемент. За да получите само преките дъщерни възли, които са елементи, използвайте element.children.

Ако запазите референция към списъка, той продължава да отразява добавянето и премахването на дъщерни възли. Премахването на възел при обхождане напред може да измести индексите и да доведе до пропускане на следващия възел. Ако искате да обходите непроменящ се набор от записи, използвайте Array.from(node.childNodes) преди промените. Масивът съдържа референции към същите възли, а не техни копия.

Примери

{
  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))
      }
    };
  }
}

Резултат

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

Изпълнете кода в конзолата на браузъра на HTML страница. Дължината на запазения списък нараства от `0` на `2`, макар че родителският възел не е свързан със страницата. Редът в JSON за текстовия възел показва един интервал в кавички.

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

  • JavaScript · Урок 16 · Напреднало · Версия: 4

Източници