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

CKTIS / JavaScript

Encontrar um elemento pelo ID e alterar o seu estado `hidden`

Encontra um elemento HTML pelo seu identificador exato, trata a ausência de resultado e usa `hidden` para alterar o atributo sem remover o elemento do DOM.

Versão: Current web platform; runtime support varies

Sintaxe

// 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) pesquisa na árvore do documento. Passa o identificador sem o prefixo # dos seletores CSS; a pesquisa distingue maiúsculas de minúsculas. O método devolve o primeiro Element correspondente pela ordem da árvore, ou null. Os identificadores devem ser únicos. Um elemento ainda não inserido não é encontrado, mas um elemento oculto continua a ser encontrado.

Verifica o resultado antes de aceder a .hidden: ler ou atribuir uma propriedade em null lança um TypeError. O resultado também pode ser um elemento que não seja HTML, como um elemento SVG; instanceof HTMLElement verifica o tipo no mesmo ambiente global. São API da plataforma Web, não funcionalidades de ECMAScript 2024. A propriedade distinta document.hidden, só de leitura, indica a visibilidade do documento, não a de um elemento.

HTMLElement.hidden reflete o atributo HTML hidden do elemento. Atribuir true define o atributo com um valor vazio, enquanto false o remove. A leitura devolve false se o atributo estiver ausente e true no estado oculto normal; até setAttribute("hidden", "false") oculta o elemento. Quando "until-found" é suportado, podes atribuir e ler essa cadeia de caracteres: a pesquisa na página ou a navegação para um fragmento podem revelar o conteúdo.

hidden não remove o nó nem protege dados sensíveis. Remover o atributo não garante visibilidade: CSS ou um antepassado oculto podem continuar a ocultar o elemento, e a propriedade CSS display pode ainda sobrepor-se ao efeito normal de ocultação.

Exemplos

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

Resultado

true
true true true
false false

Guarda o exemplo como ficheiro HTML, abre-o num navegador e consulta a consola de desenvolvimento. O documento separado isola o exemplo da página atual. As três linhas mostram que não há resultado antes da inserção, que se encontra o mesmo elemento quando está oculto e que atribuir `false` remove o atributo.

Lições relacionadas

  • JavaScript · Lição 35 · Avançado · Versão: 4

Fontes