CKTIS / JavaScript
Navegación por el DOM: hijos, nombre de etiqueta, padre y hermanos
Lee el nombre de etiqueta y navega entre los hijos directos, el padre y los elementos vecinos. Distingue cuándo una colección se actualiza y cuándo una propiedad puede devolver `null`.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
element.children // HTMLCollection
element.tagName // string
element.parentElement // Element or null
element.previousElementSibling // Element or null
element.nextElementSibling // Element or nullEstas cinco propiedades del DOM son de solo lectura. Se leen con la notación de punto, sin paréntesis de llamada. Forman parte de la API del DOM, no de ECMAScript 2024; un entorno sin DOM no las proporciona.
element.children es una HTMLCollection viva de los elementos hijos directos, en el orden del DOM. Está vacía si no hay elementos hijos. element.childNodes también es una colección viva, pero es una NodeList de todos los nodos hijos directos, incluidos el texto y los comentarios. Si guardas children, la colección se actualiza al cambiar el DOM. Array.from(element.children) guarda las referencias actuales y su orden en un array, sin clonar los elementos.
element.tagName devuelve el nombre cualificado de la etiqueta como cadena, incluido el prefijo si existe. Para un elemento del espacio de nombres HTML en un documento HTML, las letras ASCII se convierten en mayúsculas, como en "DIV". En los demás casos se conserva la distinción entre mayúsculas y minúsculas, también en SVG dentro de HTML y en XHTML procesado como XML. Para comparar teniendo en cuenta el espacio de nombres, usa localName junto con namespaceURI.
element.parentElement procede de Node. Devuelve el padre directo si es un elemento; si no hay padre o no es un elemento, devuelve null. Por ejemplo, para el elemento raíz de un documento, parentElement es null, pero parentNode devuelve el Document.
previousElementSibling y nextElementSibling devuelven, respectivamente, el elemento más cercano anterior o posterior bajo el mismo padre, o null si no lo hay. Omiten el texto y los comentarios, a diferencia de previousSibling y nextSibling, que pueden devolver esos nodos. Comprueba si el resultado es null antes de leer tagName o usa element.nextElementSibling?.tagName, que da undefined si no hay un elemento hermano siguiente.
Ejemplos
<!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 el ejemplo como archivo `.html`, ábrelo en un navegador y consulta la consola de desarrollador. El ejemplo usa un documento HTML separado y no modifica la página abierta. El espacio y el comentario cuentan en `childNodes`, pero no en `children`; al añadir un elemento, solo aumenta la longitud de la colección viva.
Lecciones relacionadas
- JavaScript · Lección 34 · Intermedio · Versión: 3
Fuentes
- 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