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
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.
- Si es
scrollIntoViewOptions
Opcional Experimental-
Un booleano o un objeto con las siguientes opciones:
behavior
Opcional-
Establece la transición de la animación. Puede ser
auto
osmooth
. Por defecto esauto
. block
Opcional-
Establece el alineamiento vertical. Puede ser
start
,center
,end
, onearest
. Por defecto esstart
. inline
Opcional-
Establece el alineamiento horizontal Puede ser
start
,center
,end
, onearest
. Por defecto esnearest
.
Ejemplo
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
BCD tables only load in the browser