CKTIS / JavaScript
Document.getElementById() e documentElement: ricerca per ID ed elemento radice
`getElementById()` cerca un elemento tramite il suo ID esatto, mentre `documentElement` dà accesso all’elemento radice del documento. Entrambi possono dare `null`, ma per motivi diversi.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
doc.getElementById(id) // Element or null
doc.documentElement // Element or null; read-onlydoc.getElementById(id) cerca nell’albero attuale di doc. Passa l’ID stesso, per esempio 'Panel', senza aggiungere il prefisso # di un selettore CSS. La ricerca distingue maiuscole e minuscole e restituisce un Element, oppure null se non trova corrispondenze. In HTML gli ID devono essere univoci nel proprio albero. In caso di duplicati viene restituita la prima corrispondenza nell’ordine dell’albero.
La ricerca esclude gli elementi non inseriti in quell’albero e quelli interni agli alberi dello shadow DOM. Se lo script viene eseguito prima dell’inserimento, il risultato può essere null: controllalo prima di accedere a una sua proprietà. Una chiamata successiva ripete la ricerca, ma un riferimento già salvato non cambia quando l’elemento viene rimosso.
doc.documentElement è una proprietà di sola lettura, non un metodo. Restituisce l’elemento radice a prescindere dal suo ID: html in un tipico documento HTML, oppure l’elemento che funge da radice in XML. Non è né il nodo Document stesso né body. Se non esiste un elemento radice, il valore è null.
Entrambi appartengono all’API DOM del Web, non a ECMAScript 2024. Il supporto di JavaScript non garantisce da solo la disponibilità di document.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document ID lookup and root element</title>
</head>
<body>
<script>
(() => {
const doc = document.implementation.createHTMLDocument('Demo');
const panel = doc.createElement('div');
panel.id = 'Panel';
console.log(doc.documentElement.localName);
console.log(doc.getElementById('Panel'));
doc.body.appendChild(panel);
console.log(doc.getElementById('Panel') === panel);
console.log(doc.getElementById('panel'));
console.log(new Document().documentElement);
})();
</script>
</body>
</html>Risultato
html null true null null
Salva l’esempio come file `.html`, aprilo in un browser e controlla i risultati nella console per sviluppatori. L’esempio crea un documento HTML separato senza modificare la pagina corrente. `'Panel'` viene trovato solo dopo l’inserimento, `'panel'` non corrisponde e un nuovo `Document` vuoto non ha un elemento radice.
Lezioni correlate
- JavaScript · Lezione 19 · Avanzato · Versione: 4
- JavaScript · Lezione 33 · Avanzato · Versione: 4