Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 null

Estas 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