Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Trovare un elemento per ID e cambiare il suo stato `hidden`

Trova un elemento HTML tramite il suo ID esatto, gestisci l’assenza di risultati e usa `hidden` per modificare l’attributo senza rimuovere l’elemento dal DOM.

Versione: Current web platform; runtime support varies

Sintassi

// These are web platform APIs, not ECMAScript 2024 features.
const element = document.getElementById(id);
if (element instanceof HTMLElement) {
  element.hidden = true;  // Set the hidden attribute.
  element.hidden = false; // Remove the hidden attribute.
}
// Hidden Until Found depends on the browser's HTML implementation:
// element.hidden = "until-found";

document.getElementById(id) cerca nell’albero del documento. Passa l’ID senza il prefisso # dei selettori CSS; maiuscole e minuscole sono distinte. Il metodo restituisce il primo Element corrispondente nell’ordine dell’albero oppure null. Gli ID devono essere univoci. Un elemento non ancora inserito non viene trovato, mentre uno nascosto sì.

Controlla il risultato prima di accedere a .hidden: leggere o assegnare una proprietà su null genera un TypeError. Il risultato può anche essere un elemento non HTML, per esempio SVG; instanceof HTMLElement verifica il tipo nello stesso ambiente globale. Sono API della piattaforma web, non funzionalità di ECMAScript 2024. La proprietà distinta document.hidden, di sola lettura, indica la visibilità del documento, non quella di un elemento.

HTMLElement.hidden riflette l’attributo HTML hidden dell’elemento. Assegnare true imposta l’attributo con valore vuoto; assegnare false lo rimuove. La lettura restituisce false quando l’attributo manca e true nello stato nascosto ordinario; anche setAttribute("hidden", "false") nasconde l’elemento. Dove "until-found" è supportato, puoi assegnare e leggere questa stringa: la ricerca nella pagina o la navigazione verso un frammento possono rendere visibile il contenuto.

hidden non rimuove il nodo e non protegge i dati sensibili. Rimuovere l’attributo non garantisce la visibilità: il CSS o un antenato nascosto possono ancora occultare l’elemento, e la proprietà CSS display può anche annullare il normale effetto di occultamento.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>getElementById and hidden</title>
</head>
<body>
<script>
(() => {
  const doc = document.implementation.createHTMLDocument();
  const panel = doc.createElement("section");
  panel.id = "notice";

  console.log(doc.getElementById("notice") === null);
  doc.body.appendChild(panel);

  const match = doc.getElementById("notice");
  if (!(match instanceof HTMLElement)) {
    throw new Error("Expected an HTML element with id notice");
  }

  match.hidden = true;
  console.log(`${match.hidden} ${match.hasAttribute("hidden")} ${doc.getElementById("notice") === match}`);

  match.hidden = false;
  console.log(`${match.hidden} ${match.hasAttribute("hidden")}`);
})();
</script>
</body>
</html>

Risultato

true
true true true
false false

Salva l’esempio come file HTML, aprilo in un browser e controlla la console per sviluppatori. Il documento separato isola l’esempio dalla pagina corrente. Le tre righe mostrano l’assenza di risultati prima dell’inserimento, che lo stesso elemento viene trovato anche se nascosto e che assegnare `false` rimuove l’attributo.

Lezioni correlate

  • JavaScript · Lezione 35 · Avanzato · Versione: 4

Fonti