Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

HTMLElement.hidden — ocultar um elemento

HTMLElement.hidden reflete o atributo hidden: devolve false, true ou «until-found». Não é um teste de visibilidade.

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

Sintaxe

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

HTMLElement.hidden reflete o atributo hidden. Ao ler a propriedade, obtém-se false se o atributo estiver ausente, "until-found" para esse estado e true nos restantes casos.

Atribuir true oculta o elemento; atribuir false remove o atributo. setAttribute("hidden", "false") continua a ocultá-lo: um valor inválido significa o estado Hidden.

"until-found" permite revelar o elemento através de uma pesquisa ou da navegação para um fragmento: o navegador dispara beforematch e, em seguida, remove o atributo. Este estado requer suporte do navegador; os contornos e os espaçamentos podem permanecer.

Esta é uma API de HTML, não de ECMAScript. CSS pode sobrepor-se ao seu efeito; a propriedade não mede a visibilidade. A ocultação também se aplica às tecnologias de apoio, mas não desativa scripts nem o envio de controlos de formulário.

Exemplos

(() => {
  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);
})();

Resultado

false
true true
false false
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes