Element.scrollIntoView()
Baseline
Ampliamente disponible
*
Esta característica está consolidada y funciona en muchos dispositivos y versiones de navegador. Está disponible en todos los navegadores desde enero de 2020.
* Algunas partes de esta característica pueden tener distintos niveles de compatibilidad.
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
scrollIntoViewOptionsOpcional-
Un booleano o un objeto con las siguientes opciones:
behaviorOpcional-
Establece la transición de la animación. Puede ser
autoosmooth. Por defecto esauto. blockOpcional-
Establece el alineamiento vertical. Puede ser
start,center,end, onearest. Por defecto esstart. inlineOpcional-
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
| Especificación |
|---|
| CSSOM View Module # dom-element-scrollintoview |