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

CKTIS / JavaScript

HTMLElement.hidden — masquer un élément

HTMLElement.hidden reflète l’attribut hidden : la propriété renvoie false, true ou « until-found ». Elle ne permet pas de vérifier la visibilité.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

element.hidden; element.hidden = true; element.hidden = false; element.hidden = "until-found";

HTMLElement.hidden reflète l’attribut hidden. Sa lecture renvoie false si l’attribut est absent, "until-found" pour cet état et true dans les autres cas.

Affecter true masque l’élément ; affecter false supprime l’attribut. setAttribute("hidden", "false") masque quand même l’élément : une valeur invalide correspond à l’état Hidden.

"until-found" permet de révéler l’élément lors d’une recherche ou d’une navigation vers un fragment : le navigateur déclenche beforematch, puis supprime l’attribut. Cet état nécessite la prise en charge du navigateur ; les bordures et les espacements peuvent rester visibles.

Il s’agit d’une API HTML, et non d’ECMAScript. CSS peut en remplacer l’effet ; la propriété ne mesure pas la visibilité. Le masquage s’applique aussi aux technologies d’assistance, mais ne désactive ni les scripts ni l’envoi des contrôles de formulaire.

Exemples

(() => {
  const panel = document.createElement("div");
  console.log(panel.hidden);

  panel.hidden = true;
  console.log(panel.hidden, panel.hasAttribute("hidden"));

  panel.hidden = false;
  console.log(panel.hidden, panel.hasAttribute("hidden"));

  panel.setAttribute("hidden", "false");
  console.log(panel.hidden);
})();

Résultat

false
true true
false false
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources