CKTIS / JavaScript
Navegação no DOM: filhos, nome da etiqueta, pai e irmãos
Lê o nome da etiqueta e navega entre filhos diretos, o pai e elementos vizinhos. Distingue uma coleção que se atualiza de uma propriedade que pode devolver `null`.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
element.children // HTMLCollection
element.tagName // string
element.parentElement // Element or null
element.previousElementSibling // Element or null
element.nextElementSibling // Element or nullEstas cinco propriedades do DOM são apenas de leitura. Lê-as com a notação de ponto, sem parênteses de chamada. Pertencem à API do DOM, não ao ECMAScript 2024; um ambiente de execução sem DOM não as disponibiliza.
element.children é uma HTMLCollection dinâmica de elementos filhos diretos, pela ordem do DOM. Se não houver elementos filhos, está vazia. element.childNodes também é dinâmica, mas é uma NodeList de todos os nós filhos diretos, incluindo texto e comentários. Uma coleção children já guardada atualiza-se quando o DOM muda. Array.from(element.children) guarda num array as referências atuais e a respetiva ordem, sem clonar os elementos.
element.tagName devolve o nome qualificado da etiqueta como cadeia de caracteres, incluindo o prefixo, se existir. Para um elemento no espaço de nomes HTML num documento HTML, as letras ASCII passam a maiúsculas, como em "DIV". Nos restantes casos, as maiúsculas e minúsculas são preservadas, inclusive em SVG num documento HTML e em XHTML processado como XML. Para comparações que tenham em conta o espaço de nomes, usa localName em conjunto com namespaceURI.
element.parentElement vem de Node. Devolve o pai direto se este for um elemento, ou null se não houver pai ou se este não for um elemento. Por exemplo, no elemento raiz de um documento, parentElement é null, mas parentNode devolve o Document.
previousElementSibling e nextElementSibling devolvem, respetivamente, o elemento mais próximo antes ou depois do atual, sob o mesmo pai, ou null se não existir. Ignoram o texto e os comentários, ao contrário de previousSibling e nextSibling, que podem devolver esses nós. Verifica se o resultado é null antes de ler tagName ou usa element.nextElementSibling?.tagName, que dá undefined se não existir um elemento irmão a seguir.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOM element traversal</title>
</head>
<body>
<script>
{
const doc = document.implementation.createHTMLDocument();
const box = doc.createElement('div');
const first = doc.createElement('span');
const second = doc.createElement('em');
box.append(first, ' ', doc.createComment('gap'), second);
const live = box.children;
const snapshot = Array.from(live);
console.log(JSON.stringify([live.length, box.childNodes.length, live[0].tagName]));
console.log(JSON.stringify([
first.parentElement?.tagName,
first.nextElementSibling?.tagName,
second.previousElementSibling?.tagName,
first.previousElementSibling,
second.nextElementSibling
]));
box.append(doc.createElement('strong'));
console.log(JSON.stringify([
live.length, snapshot.length,
doc.documentElement.parentElement,
doc.documentElement.parentNode === doc
]));
}
</script>
</body>
</html>Resultado
[2,4,"SPAN"] ["DIV","EM","SPAN",null,null] [3,2,null,true]
Guarda o exemplo como ficheiro `.html`, abre-o num navegador e consulta a consola de desenvolvimento. O exemplo usa um documento HTML separado e não altera a página aberta. O espaço e o comentário contam em `childNodes`, mas não em `children`; acrescentar um elemento aumenta apenas o comprimento da coleção dinâmica.
Lições relacionadas
- JavaScript · Lição 34 · Intermédio · Versão: 3
Fontes
- Element: children property
- Element: tagName property
- Node: parentElement property
- Element: previousElementSibling property
- Element: nextElementSibling property
- Node: childNodes property
- HTMLCollection
- Element: localName property
- Element: namespaceURI property
- DOMImplementation: createHTMLDocument() method
- HTML Standard: Terminology
- ECMAScript 2024 Language Specification: Optional Chains