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

CKTIS / JavaScript

HTMLElement: visibilidade, interação e altura do elemento

Aprenda a usar hidden, draggable, tabIndex, click(), offsetHeight e title em HTMLElement. Distinga propriedades modificáveis, um método de ativação e uma medição só de leitura, tendo em conta a navegação por teclado e a disposição CSS.

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 = true; // Alternatives: false or "until-found"
element.draggable = true; // Alternative: false
element.tabIndex = integer;
element.click();
const height = element.offsetHeight;
element.title = "Supplementary information";

HTMLElement disponibiliza APIs do navegador para elementos HTML, não funcionalidades do próprio ECMAScript. A presença do Node 24 num projeto não comprova que estas APIs estejam disponíveis. As funcionalidades básicas aqui descritas são amplamente suportadas; verifique separadamente o suporte do valor especial "until-found" nos navegadores de destino.

HTMLElement.hidden reflete o atributo hidden: true significa que o elemento está oculto, false que esse estado não está ativo e "until-found" permite revelar conteúdo através da pesquisa na página ou da navegação por fragmentos. Não é um teste geral de visibilidade: o CSS também afeta a apresentação. HTMLElement.draggable é um valor booleano que controla se um elemento pode ser arrastado; não implementa uma operação completa de largar. O atributo HTML draggable é enumerado, não booleano: usa "true" e "false"; quando é omitido, aplica-se o comportamento auto.

HTMLElement.tabIndex é um número inteiro. O valor 0 permite que um elemento participe na navegação sequencial por teclado se cumprir as restantes condições. Definir o valor como 0 não faz com que um elemento oculto ou inerte (inert), ou um controlo desativado, receba o foco nessa sequência. A ordem depende dos âmbitos de navegação do foco e nem sempre coincide com a ordem global do documento. O valor -1 normalmente exclui o elemento da sequência, mas continua a permitir focá-lo programaticamente se puder receber foco. No mesmo âmbito, os valores positivos têm prioridade sobre 0; evite-os para não tornar a navegação confusa. HTMLElement.click() é um método, não uma propriedade booleana: ativa um clique programaticamente, exceto num controlo de formulário desativado. Não substitui um gesto completo do utilizador.

HTMLElement.offsetHeight é só de leitura: devolve a altura do esquema como um número inteiro em píxeis CSS, incluindo o preenchimento, as bordas e qualquer barra de deslocamento horizontal, mas não as margens. Se o elemento ou um antecessor tiver display: none, o resultado é 0. HTMLElement.title contém informações suplementares, normalmente apresentadas como uma dica quando o ponteiro passa sobre o elemento.

O exemplo cria um elemento e um botão, define as propriedades, chama click() e lê a altura. As dimensões explícitas dão o valor esperado 34; depois de display: none, o resultado esperado é 0. No final, remove os elementos para limpar o documento.

Exemplos

(() => {
  const panel = document.createElement("div");
  const button = document.createElement("button");
  button.type = "button";
  button.textContent = "Show panel";
  panel.textContent = "Demo";
  panel.hidden = true;
  panel.draggable = true;
  panel.tabIndex = 0;
  panel.title = "Demo panel";
  panel.style.cssText = "box-sizing:content-box;height:20px;padding:5px;border:2px solid black;overflow:hidden";
  document.body.append(button, panel);

  let clicks = 0;
  button.addEventListener("click", () => {
    clicks += 1;
    panel.hidden = false;
  });
  button.click();
  console.log(`${panel.hidden} | ${panel.draggable} | ${panel.tabIndex} | ${panel.title} | ${clicks} | ${panel.offsetHeight}`);

  panel.hidden = true;
  panel.style.display = "none";
  console.log(`${panel.hidden} | ${panel.offsetHeight}`);
  button.remove();
  panel.remove();
})();

Resultado

false | true | 0 | Demo panel | 1 | 34
true | 0

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.

Fontes