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 September 2020.

El método scrollIntoView() de la interfaz Element desplaza el contenedor principal del elemento de forma que el elemento sobre el cual se invoca scrollIntoView() sea visible al usuario.

Sintaxis

js
element.scrollIntoView(); // Equivalente a element.scrollIntoView(true)
element.scrollIntoView(alignToTop); // Argumentos booleanos
element.scrollIntoView(scrollIntoViewOptions); // Argumento objeto

Parámetros

alignToTop

Es un valor Boolean:

  • Si es true, la parte superior del elemento se alineará con la parte superior del área visible del elemento desplazable antecesor.
  • Si es false, la parte inferior del elemento se alineará con la parte inferior del área visible del elemento desplazable antecesor.
scrollIntoViewOptions Opcional

Un booleano o un objeto con las siguientes opciones:

behavior Opcional

Establece la transición de la animación. Puede ser auto o smooth. Por defecto es auto.

block Opcional

Establece el alineamiento vertical. Puede ser start, center, end, o nearest. Por defecto es start.

inline Opcional

Establece el alineamiento horizontal Puede ser start, center, end, o nearest. Por defecto es nearest.

Ejemplo

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

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

Notas

Puede que el desplazamiento no sea llevado completamente a la parte superior o inferior dependiente de la disposición de otros elementos.

Especificaciones

Specification
CSSOM View Module
# dom-element-scrollintoview

Compatibilidad con navegadores