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