CKTIS / JavaScript
HTMLElement.hidden e click(): ocultar um elemento ou disparar um clique
`hidden` reflete um atributo HTML, enquanto `click()` dispara um clique sintético. Ocultar um elemento não o desativa nem impede um clique através do código.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
element.hidden
element.hidden = true // Set the hidden attribute
element.hidden = false // Remove the hidden attribute
element.hidden = "until-found"
element.click() // No arguments; returns undefinedA propriedade hidden, de leitura e escrita, reflete o atributo HTML hidden. Devolve false se o atributo estiver ausente, "until-found" no estado «oculto até ser encontrado» e true nos restantes casos. Atribuir true define um atributo vazio; atribuir false remove-o. A cadeia de caracteres "false" não é o valor booleano false: deixa o elemento no estado oculto.
Nos navegadores que suportam "until-found", a pesquisa na página ou a navegação para um fragmento do URL pode revelar o conteúdo. hidden indica o estado do atributo, não a visibilidade real no ecrã: o CSS pode alterar a apresentação. Ocultar um elemento não o retira do DOM nem protege o seu conteúdo.
element.click() não recebe argumentos e devolve undefined. Dispara de forma síncrona um evento sintético click no elemento com event.isTrusted === false. Não faz nada se o controlo de formulário estiver desativado ou se já estiver a decorrer uma chamada a click() no mesmo elemento. Estar oculto não impede, por si só, a execução do método.
Um clique sintético pode executar a ação predefinida do elemento, como marcar ou desmarcar uma caixa de seleção, mas não gera por si só a ativação do utilizador que algumas API exigem. hidden e click() pertencem à plataforma web, não ao ECMAScript 2024, e exigem um ambiente que disponibilize o DOM de HTML.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>HTMLElement.hidden and click()</title>
<script>
const panel = document.createElement("section");
const button = document.createElement("button");
button.type = "button";
panel.hidden = true;
button.hidden = true;
button.addEventListener("click", (event) => {
console.log(`click: isTrusted=${event.isTrusted}`);
panel.hidden = false;
});
console.log(`before: panel.hidden=${panel.hidden}`);
button.click();
button.disabled = true;
button.click();
console.log(`after: panel.hidden=${panel.hidden}`);
</script>Resultado
before: panel.hidden=true click: isTrusted=false after: panel.hidden=false
Guarda o exemplo completo num ficheiro HTML e abre-o num navegador. O resultado aparece na consola de desenvolvimento. Nenhum dos elementos é inserido na página: o exemplo mostra o estado do atributo e o comportamento do evento, não o resultado visual. O primeiro clique remove `hidden` do painel; o segundo não executa a função de tratamento do evento.
Lições relacionadas
- JavaScript · Lição 41 · Intermédio · Versão: 3