CKTIS / JavaScript
Navigare nel DOM: figli, nome del tag, genitore e fratelli
Leggi il nome del tag e naviga tra figli diretti, genitore ed elementi vicini. Distingui una collezione che si aggiorna da una proprietà che può restituire `null`.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
element.children // HTMLCollection
element.tagName // string
element.parentElement // Element or null
element.previousElementSibling // Element or null
element.nextElementSibling // Element or nullQueste cinque proprietà del DOM sono di sola lettura. Si leggono con la notazione a punto, senza parentesi di chiamata. Fanno parte dell’API del DOM, non di ECMAScript 2024; un ambiente senza DOM non le fornisce.
element.children è una HTMLCollection dinamica degli elementi figli diretti, nell’ordine del DOM. Se non ci sono elementi figli, è vuota. Anche element.childNodes è dinamica, ma è una NodeList di tutti i nodi figli diretti, compresi testo e commenti. Una collezione children già salvata si aggiorna quando cambia il DOM. Array.from(element.children) salva in un array i riferimenti correnti e il loro ordine, senza clonare gli elementi.
element.tagName restituisce il nome qualificato del tag come stringa, con il prefisso se presente. Per un elemento nello spazio dei nomi HTML in un documento HTML, le lettere ASCII diventano maiuscole, come in "DIV". Negli altri casi si mantengono maiuscole e minuscole, anche per SVG in un documento HTML e per XHTML elaborato come XML. Per confronti che tengano conto dello spazio dei nomi, usa localName insieme a namespaceURI.
element.parentElement deriva da Node. Restituisce il genitore diretto se è un elemento, oppure null se il genitore non esiste o non è un elemento. Ad esempio, per l’elemento radice di un documento, parentElement vale null, mentre parentNode restituisce il Document.
previousElementSibling e nextElementSibling restituiscono rispettivamente l’elemento più vicino prima o dopo quello corrente, con lo stesso genitore, oppure null se non esiste. Saltano testo e commenti, a differenza di previousSibling e nextSibling, che possono restituire quei nodi. Verifica che il risultato non sia null prima di leggere tagName, oppure usa element.nextElementSibling?.tagName, che dà undefined se non c’è un elemento fratello successivo.
Esempi
<!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>Risultato
[2,4,"SPAN"] ["DIV","EM","SPAN",null,null] [3,2,null,true]
Salva l’esempio come file `.html`, aprilo in un browser e controlla la console per sviluppatori. L’esempio usa un documento HTML separato e non modifica la pagina aperta. Lo spazio e il commento contano in `childNodes` ma non in `children`; aggiungendo un elemento aumenta solo la lunghezza della collezione dinamica.
Lezioni correlate
- JavaScript · Lezione 34 · Intermedio · Versione: 3
Fonti
- 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