Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Documento DOM: ricerca per ID, elemento radice e titolo

Trova un elemento tramite il suo ID esatto, accedi all’elemento radice e leggi o modifica il titolo del documento. Distingui un nodo assente da una stringa vuota.

Versione: Current web platform; runtime support varies

Sintassi

document.getElementById(id)
document.documentElement
document.title
document.title = value

document.getElementById(id) cerca nell’albero del documento un elemento il cui id corrisponda esattamente al valore fornito, distinguendo maiuscole e minuscole. Passa l’ID senza aggiungere #: l’argomento non è un selettore CSS. Il metodo restituisce un Element o null; controlla il risultato prima di accedere alle proprietà dell’elemento. Gli ID devono essere univoci nell’albero. Se ci sono duplicati, il metodo restituisce la prima corrispondenza nell’ordine dell’albero.

La ricerca usa l’albero così com’è al momento della chiamata. Non trova elementi non ancora inseriti nel documento né elementi in un albero shadow separato. document.documentElement è di sola lettura: restituisce l’elemento radice, normalmente html in un documento HTML, oppure null se non c’è un elemento radice. Non è document.body.

document.title è una proprietà di tipo stringa che si può leggere e scrivere, non il nodo title, l’attributo title di un elemento o un’intestazione visibile. In un tipico documento HTML, la lettura rimuove i caratteri di spaziatura ASCII alle estremità e riduce ogni sequenza interna a un singolo spazio. Senza un elemento title, restituisce "". L’assegnazione sostituisce il contenuto del titolo con testo, non con markup HTML. Se title manca, lo crea in head se presente; altrimenti non fa nulla. Se la radice è un svg nello spazio dei nomi SVG, l’assegnazione aggiorna o crea un figlio diretto title nello spazio dei nomi SVG, da cui viene letto il titolo.

Gli standard DOM e HTML definiscono queste API della piattaforma web. Per usarle non è necessario ECMAScript 2024. Per un documento visualizzato in una scheda del browser, il titolo compare normalmente sull’etichetta della scheda. Un ambiente senza DOM non è tenuto a fornire document.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DOM document example</title>
</head>
<body>
  <script>
    {
      const doc = document.implementation.createHTMLDocument("Draft");
      const item = doc.createElement("p");
      item.id = "status";

      console.log(doc.title);
      console.log(doc.getElementById("status") === null);
      doc.body.append(item);
      console.log(doc.getElementById("status") === item);
      console.log(doc.getElementById("Status") === null);
      console.log(doc.documentElement.localName);

      doc.title = "  Ready   to publish  ";
      console.log(doc.title);
    }
  </script>
</body>
</html>

Risultato

Draft
true
true
true
html
Ready to publish

Salva l’intero esempio come file HTML, aprilo in un browser e controlla la console degli strumenti di sviluppo. Crea un documento HTML separato, quindi non modifica la pagina corrente né il titolo della scheda. I tre valori `true` mostrano, nell’ordine, l’assenza di una corrispondenza prima dell’inserimento, l’identità dell’oggetto dopo l’inserimento e la distinzione tra maiuscole e minuscole.

Lezioni correlate

  • JavaScript · Lezione 38 · Avanzato · Versione: 4

Fonti