Element.scrollIntoView()
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since janeiro de 2020.
* Some parts of this feature may have varying levels of support.
Experimental: Esta é uma tecnologia experimental
Verifique a tabela de compatibilidade entre Navegadores cuidadosamente antes de usar essa funcionalidade em produção.
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
alignToTopOptional-
É um valor
Boolean:- Se
true, a parte superior do elemento ficará alinhada com o topo da área visível do elemento-pai. Correponde ascrollIntoViewOptions: {block: "start", inline: "nearest"}. Este é o valor default. Se false, a parte inferior do elemento ficará alinhada com o fundo da área visível do elemento-pai. Corresponde ascrollIntoViewOptions: {block: "end", inline: "nearest"}
- Se
scrollIntoViewOptionsOptional-
Um booleano ou um objeto com as seguintes opções:
webidl{ behavior: "auto" | "instant" | "smooth", block: "start" | "center" | "end" | "nearest", inline: "start" | "center" | "end" | "nearest" }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
| Specification |
|---|
| CSSOM View Module # dom-element-scrollintoview |
Compatibilidade com navegadores
Loading…
Veja também
Element.scrollIntoViewIfNeeded()Não padrão