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_NODEWł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