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