Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
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 é umatecnologia experimental
Verifique atabela de compatibilidade entre Navegadores cuidadosamente antes de usar essa funcionalidade em produção.
O métodoElement.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 booleanoselement.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
scrollIntoViewOptionsOptionalUm 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 |