Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Trouver un élément par son ID et modifier son état `hidden`

Retrouvez un élément HTML par son identifiant exact, gérez l’absence de résultat et utilisez `hidden` pour modifier l’attribut sans retirer l’élément du DOM.

Version : Current web platform; runtime support varies

Syntaxe

// 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) cherche dans l’arbre du document. Passez l’identifiant lui-même, sans le préfixe # des sélecteurs CSS ; la casse compte. La méthode renvoie le premier Element correspondant dans l’ordre de l’arbre, ou null. Les identifiants doivent être uniques. Un élément pas encore inséré est introuvable, mais un élément masqué reste accessible à la recherche.

Vérifiez le résultat avant d’accéder à .hidden : lire ou affecter une propriété sur null déclenche une TypeError. Le résultat peut aussi être un élément non HTML, par exemple SVG ; instanceof HTMLElement vérifie son type dans le même environnement global. Il s’agit d’API de la plateforme web, pas de fonctionnalités d’ECMAScript 2024. La propriété distincte document.hidden, en lecture seule, indique la visibilité du document, et non celle d’un élément.

HTMLElement.hidden reflète l’attribut HTML hidden de l’élément. Affecter true crée l’attribut avec une valeur vide ; affecter false le supprime. La lecture renvoie false si l’attribut est absent et true dans l’état masqué ordinaire ; même setAttribute("hidden", "false") masque l’élément. Si "until-found" est pris en charge, vous pouvez affecter et lire cette chaîne : la recherche dans la page ou la navigation vers un fragment peut alors révéler le contenu.

hidden ne retire pas le nœud et ne protège pas les données sensibles. Supprimer l’attribut ne garantit pas la visibilité : du CSS ou un ancêtre masqué peut encore cacher l’élément, et la propriété CSS display peut aussi neutraliser le masquage ordinaire.

Exemples

<!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>

Résultat

true
true true true
false false

Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console de développement. Le document distinct isole l’exemple de la page courante. Les trois lignes montrent l’absence de résultat avant l’insertion, que le même élément reste trouvable une fois masqué, puis que l’affectation de `false` supprime l’attribut.

Leçons associées

  • JavaScript · Leçon 35 · Avancé · Version : 4

Sources