Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Uzly DOM: typ, hodnota a podřízené uzly

Rozlišujte textové uzly od elementů, čtěte hodnotu jednotlivého uzlu a při procházení přímých potomků počítejte s průběžnými změnami seznamu.

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

Syntaxe

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

Vlastnost node.nodeType je jen pro čtení a vrací celé číslo určující druh uzlu. Porovnejte ho pomocí === s konstantami rozhraní Node: Node.TEXT_NODE (3) označuje textový uzel a Node.ELEMENT_NODE (1) element. Element a text uvnitř něj jsou samostatné uzly. Tato rozhraní DOM patří k webové platformě, nikoli do ECMAScriptu 2024. Běhové prostředí JavaScriptu nemusí DOM poskytovat.

node.nodeValue se vztahuje k samotnému uzlu. U textového uzlu vrací jeho text; přiřazení řetězce tento text nahradí, aniž by se řetězec interpretoval jako HTML. Také komentář má řetězcovou hodnotu. U elementu vlastnost vrací null a přiřazení nemá žádný účinek, ani když element obsahuje text. Spojený text potomků elementu bez komentářů a instrukcí pro zpracování získáte pomocí element.textContent.

Vlastnost node.childNodes je jen pro čtení a vrací průběžně aktualizovaný seznam NodeList přímých potomků, ne všech potomků. Indexy začínají nulou a seznam není pole. Zahrnuje elementy, textové uzly a komentáře. Odsazení a zalomení řádků v HTML mohou vytvořit textové uzly obsahující jen bílé znaky, takže childNodes[0] nemusí být element. Pouze přímé potomky typu element získáte pomocí element.children.

I když si odkaz na seznam uložíte, seznam dál odráží přidávání a odebírání potomků. Odebrání uzlu při procházení od začátku ke konci může posunout indexy a způsobit přeskočení následujícího uzlu. Potřebujete-li procházet neměnnou sestavu položek, použijte před úpravami Array.from(node.childNodes). Vzniklé pole obsahuje odkazy na stejné uzly, nikoli jejich kopie.

Příklady

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

Výsledek

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

Spusťte kód v konzoli prohlížeče na stránce HTML. Délka uloženého seznamu vzroste z `0` na `2`, přestože rodičovský uzel není připojený ke stránce. Řádek JSON pro textový uzel ukáže jednu mezeru v uvozovkách.

Související lekce

  • JavaScript · Lekce 16 · Pokročilá · Verze: 4

Zdroje