Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Ricerca per ID e focus: getElementById() e activeElement

`document.getElementById(id)` cerca un elemento tramite il suo identificatore, mentre `document.activeElement` indica dove si trova il focus della tastiera dal punto di vista del documento.

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

Sintassi

document.getElementById(id) // call: Element or null
document.activeElement     // read-only property: Element or null

document.getElementById(id) è un metodo che cerca un valore id nell’albero del documento in questione. Passa l’identificatore così com’è, senza il prefisso # dei selettori CSS. La ricerca distingue maiuscole e minuscole. Il metodo restituisce un Element oppure null se non trova corrispondenze. Gli ID devono essere univoci all’interno di un albero; in caso di duplicati, il metodo restituisce la prima corrispondenza nell’ordine dell’albero.

La ricerca esclude i nodi scollegati dal documento e non entra negli alberi dello Shadow DOM né nei documenti degli elementi iframe. DocumentFragment, e quindi anche ShadowRoot, ha un proprio metodo getElementById(); un normale Element non lo ha. Prima di usare il risultato controlla che non sia null, oppure usa ?. se l’elemento può mancare.

document.activeElement è una proprietà di sola lettura, non un metodo. Restituisce l’Element che rappresenta il focus corrente della tastiera dal punto di vista del documento. Se il focus è in un albero dello Shadow DOM o in un documento incorporato, il documento esterno vede rispettivamente l’host dello Shadow DOM o l’elemento iframe. Per esaminare l’interno, leggi activeElement su uno ShadowRoot accessibile o sul documento del frame se ha la stessa origine. Se il focus si riferisce al documento stesso, la proprietà restituisce il suo body o, in mancanza di questo, documentElement se esiste. Restituisce null quando nell’albero interrogato non è applicabile alcun elemento o valore di ripiego.

Il focus non è la selezione del testo e cercare un elemento non gli assegna il focus. Se target non è null, document.activeElement === target verifica che si tratti dello stesso nodo. Rileggi la proprietà dopo un cambio di focus: un valore salvato non si aggiorna da solo. Sono API della piattaforma web, non funzionalità di ECMAScript 2024; un ambiente di esecuzione senza il DOM del browser non è tenuto a fornire document.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ID lookup and focus</title>
</head>
<body>
<script>
{
  const other = document.createElement('input');
  const target = document.createElement('input');
  target.id = 'cktis-target';
  document.body.append(other, target);

  try {
    const found = document.getElementById('cktis-target');
    other.focus();
    console.log(found === target);
    console.log(found === document.activeElement);

    found?.focus();
    console.log(found === document.activeElement);
    console.log(document.getElementById('CKTIS-target') === null);
  } finally {
    other.remove();
    target.remove();
  }
}
</script>
</body>
</html>

Risultato

true
false
true
true

Salva l’esempio come file HTML, aprilo in una scheda del browser in primo piano e poi controlla la console del browser. Se il browser consente di assegnare il focus tramite codice, le prime tre righe mostrano che l’elemento viene trovato, inizialmente non ha il focus e poi lo riceve. L’ultima riga conferma che cambiare le maiuscole impedisce la corrispondenza.

Lezioni correlate

  • JavaScript · Lezione 18 · Avanzato · Versione: 4

Fonti