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

CKTIS / JavaScript

Element.hasAttribute() e Element.scrollIntoView()

Verifica se um elemento tem um dado atributo e decide se deves deslocar a vista até ele. Distingue a presença do valor do atributo e o deslocamento da atribuição do foco.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

element.hasAttribute(name)
element.scrollIntoView()
element.scrollIntoView(alignToTop)
element.scrollIntoView(options)

element.hasAttribute(name) devolve true se o atributo indicado estiver presente no momento da chamada e false caso contrário. Tanto uma cadeia vazia como a cadeia "false" contam como presença. Usa getAttribute(name) para ler o valor (null se o atributo estiver ausente) e hasAttributeNS(namespace, localName) para verificar pelo espaço de nomes e pelo nome local. Um atributo booleano de HTML como disabled é verdadeiro pela sua mera presença: "false" não é um valor válido e não o desativa.

element.scrollIntoView() desloca, se necessário, o conteúdo dos contentores ascendentes com deslocamento, incluindo a área de visualização, para trazer o elemento para a zona visível. Não lhe atribui o foco nem faz aparecer um elemento sem caixa de apresentação, por exemplo com display: none. Sem argumento ou com true, a chamada corresponde a { block: "start", inline: "nearest" }; false altera block para "end".

No objeto de opções, block e inline definem o alinhamento nos eixos lógicos de bloco e de linha. Aceitam "start", "center", "end" ou "nearest"; esta última opção limita o movimento necessário. behavior escolhe uma animação ("smooth"), um salto ("instant") ou a definição CSS scroll-behavior ("auto", por omissão). Por omissão, container: "all" permite deslocar todos os contentores ascendentes com deslocamento; container: "nearest" limita a ação ao mais próximo, se houver suporte. É diferente do alinhamento "nearest".

Ambos os métodos são chamados numa instância de Element. Fazem parte da plataforma Web, não do ECMAScript 2024; antes da chamada, verifica se a procura do elemento não devolveu null. O suporte das opções e do valor devolvido varia consoante o navegador: scrollIntoView() pode devolver uma Promise que se resolve com um objeto que contém o booleano interrupted. Se a implementação devolver undefined, await por si só não espera pelo fim do deslocamento.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Conditional scrolling</title>
</head>
<body>
<script>
(() => {
  const panel = document.createElement("div");
  panel.style.cssText = "position:fixed;top:12px;left:12px;width:220px;height:96px;overflow:auto;border:1px solid;padding:0;writing-mode:horizontal-tb";

  const spacer = document.createElement("div");
  spacer.style.height = "240px";
  const target = document.createElement("div");
  target.style.height = "32px";
  target.textContent = "Target";
  target.setAttribute("data-jump", "false");
  panel.append(spacer, target);
  document.body.append(panel);

  const before = panel.scrollTop;
  for (const element of [spacer, target]) {
    const marked = element.hasAttribute("data-jump");
    console.log(String(marked));
    if (marked) {
      element.scrollIntoView({ behavior: "instant", block: "end", inline: "nearest" });
    }
  }
  requestAnimationFrame(() => console.log(String(panel.scrollTop > before)));
})();
</script>
</body>
</html>

Resultado

false
true
true

Guarda o exemplo como ficheiro HTML, abre-o num navegador e consulta a consola de desenvolvimento. `spacer` não tem o marcador e `target` tem `data-jump` com o valor `"false"`, pelo que só `target` provoca o deslocamento. O terceiro `true` indica que o `scrollTop` do painel aumentou; não é o valor devolvido por `scrollIntoView()`.

Lições relacionadas

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

Fontes