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.