CKTIS / JavaScript
Nós do DOM: tipo, valor e nós filhos
Distingue nós de texto de elementos, lê o valor de um nó e percorre os seus filhos diretos tendo em conta que a lista se atualiza automaticamente.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
node.nodeType
node.nodeValue
node.nodeValue = text
node.childNodes
node.nodeType === Node.TEXT_NODE
node.nodeType === Node.ELEMENT_NODEA propriedade só de leitura node.nodeType devolve um inteiro que identifica o tipo de nó. Compara-o com as constantes da interface Node através de ===: Node.TEXT_NODE (3) identifica um nó de texto e Node.ELEMENT_NODE (1) identifica um elemento. Um elemento e o texto que contém são nós distintos. Estas API do DOM pertencem à plataforma Web, não ao ECMAScript 2024; um ambiente de execução JavaScript não tem de disponibilizar o DOM.
node.nodeValue refere-se ao próprio nó. Num nó de texto, permite ler o texto; atribuir-lhe uma cadeia de caracteres substitui esse texto sem interpretar a cadeia como HTML. Um comentário também tem uma cadeia de caracteres como valor. Num elemento, a propriedade devolve null e uma atribuição não tem efeito, mesmo que o elemento contenha texto. Para ler o texto combinado dos descendentes de um elemento, excluindo comentários e instruções de processamento, usa element.textContent.
A propriedade só de leitura node.childNodes devolve uma NodeList dinâmica dos filhos diretos, não de todos os descendentes. A lista tem índices a partir de zero e não é um array. Inclui elementos, nós de texto e comentários. A indentação e as quebras de linha no HTML podem criar nós de texto compostos apenas por carateres de espaço em branco, pelo que childNodes[0] não é necessariamente um elemento. Para obter apenas os filhos diretos que são elementos, usa element.children.
Se guardares uma referência à lista, esta continua a refletir a adição e a remoção de filhos. Remover um nó durante um percurso por ordem crescente pode deslocar os índices e fazer com que saltes o nó seguinte. Se precisares de percorrer um conjunto fixo de entradas, usa Array.from(node.childNodes) antes de fazer alterações. O array contém referências aos mesmos nós, não clones.
Exemplos
{
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))
}
};
}
}Resultado
0 2 ["text",3," "] ["element",1,null] inside outside
Executa o código na consola do navegador numa página HTML. A lista guardada passa de `0` para `2`, embora o nó pai não esteja ligado à página. A linha JSON do nó de texto mostra um único espaço entre aspas.
Lições relacionadas
- JavaScript · Lição 16 · Avançado · Versão: 4