Element.scrollIntoView()

O método Element.scrollIntoView() move o elemento ao qual é aplicado para a área visível da janela do navegador.

Sintaxe

element.scrollIntoView(); // Equivalente a element.scrollIntoView(true)
element.scrollIntoView(alignToTop); // Argumentos booleanos
element.scrollIntoView(scrollIntoViewOptions); // argumento Objeto

Parâmetros

alignToTop Optional

É um valor Boolean:

• Se true, a parte superior do elemento ficará alinhada com o topo da área visível do elemento-pai. Este é o valor default.
• Se false, a parte inferior do elemento ficará alinhada com o fundo da área visível do elemento-pai.

scrollIntoViewOptions Optional

Um booleano ou um objeto com as seguintes opções:

{
  behavior: "auto"  | "instant" | "smooth",
  block:    "start" | "end",
}

Caso seja um valor booleano, true corresponde a {block: "start"} e false a {block: "end"}.

Exemplo

var element = document.getElementById("box");

element.scrollIntoView();
element.scrollIntoView(false);
element.scrollIntoView({block: "end"});
element.scrollIntoView({block: "end", behavior: "smooth"});

Observações

O elemento poderá não ser movido completamento ao topo ou ao fundo dependendo de sua composição com outros elementos.

Especificações

Compatibilidade com navegadores

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

[1] Aceita scrollIntoView com um parâmetro booleano, mas não a opção de comportamento smooth

Veja também

• Element.scrollIntoViewIfNeeded()