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

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 undefined

A 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

Fontes