Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Ricerca per ID, elemento radice e corpo del documento

Usa `getElementById()` per cercare un elemento per ID, `documentElement` per ottenere l’elemento radice e `body` per accedere al corpo HTML del documento. Tutti e tre possono restituire `null` per motivi diversi.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

doc.getElementById(id) // id: string; returns Element or null
 doc.documentElement // read-only; returns Element or null
 doc.body // returns HTMLBodyElement, HTMLFrameSetElement, or null
 doc.body = newBody // assigns an HTML body or frameset element

doc.getElementById(id) cerca nell’albero del documento doc. Passa il valore esatto di id senza aggiungere il prefisso #: non è un selettore CSS e le maiuscole sono distinte dalle minuscole. Il metodo restituisce un Element corrispondente o null. Gli ID devono essere univoci; in caso di duplicati, viene restituita la prima corrispondenza nell’ordine dell’albero. La ricerca esclude i nodi scollegati e non entra negli alberi dello Shadow DOM.

doc.documentElement è di sola lettura: restituisce l’elemento radice (<html> in un documento HTML; in XML può essere un altro elemento) o null se manca. doc.body restituisce il primo figlio diretto di <html> che sia un <body> o un <frameset> obsoleto, oppure null se non ce n’è uno. Leggi entrambe le proprietà senza parentesi.

A differenza di documentElement, puoi assegnare un valore a body per sostituire l’elemento esistente. I suoi figli non vengono spostati nel nuovo elemento. Assegnare null o un HTMLElement che non sia né <body> né <frameset> genera HierarchyRequestError. Se l’elemento non implementa HTMLElement, come nel caso di un elemento SVG, la conversione Web IDL genera un TypeError prima che il setter venga eseguito. Anche l’assegnazione di un <body> o di un <frameset> valido genera HierarchyRequestError se al documento manca l’elemento radice.

Durante l’analisi dell’HTML, il corpo o l’elemento cercato potrebbe non esistere ancora. Se il codice dipende dal markup della pagina, attendi DOMContentLoaded quando document.readyState === "loading"; altrimenti eseguilo subito. Verifica che il risultato non sia null prima di usarlo: leggere direttamente una proprietà di null genera un TypeError. Queste API sono definite dagli standard DOM e HTML, non da ECMAScript. Il riferimento a ECMAScript 2024 non indica se sono disponibili; un ambiente JavaScript non fornisce necessariamente document.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document lookup demo</title>
</head>
<body>
  <script>
    const doc = document.implementation.createHTMLDocument("Demo");
    const panel = doc.createElement("section");
    panel.id = "Panel";

    console.log(doc.documentElement.localName);
    console.log(doc.body.localName);
    console.log(doc.getElementById("Panel"));

    doc.body.appendChild(panel);
    console.log(doc.getElementById("Panel") === panel);
    console.log(doc.getElementById("panel"));
  </script>
</body>
</html>

Risultato

html
body
null
true
null

Salva l’esempio come file HTML, aprilo in un browser e controlla la console di sviluppo. Il documento HTML separato contiene già `html` e `body` e non modifica la pagina che esegue lo script. `Panel` viene trovato solo dopo l’inserimento; `panel` non corrisponde per via della differenza tra maiuscole e minuscole.

Lezioni correlate

  • JavaScript · Lezione 37 · Avanzato · Versione: 4

Fonti