Window.scrollBy()
Resumen
Desplaza el documento el número de pixels proporcionados.
Sintaxis
window.scrollBy(X, Y); window.scrollBy(opciones)
Parámetros
X
es el número de pixels a desplazar horizontalmente.Y
es el número de pixels a desplazar verticalmente.
Si X o Y son positivos, desplazarán la página hacia la derecha o hacia abajo respectivamente. Si son negativos, la desplazarán hacia la izquierda o hacia arriba respectivamente.
- or -
- opciones es un objeto con tres posibles propiedades:
- top, que es lo mismo que Y
- left, que es lo mismo que X
- behavior, que es un string cuyo valor puede ser smooth, instant, or auto. Por defecto el valor es auto
Ejemplo
// Desplazarse la longitud de una página window.scrollBy(0, window.innerHeight);
Para hacer scroll hacia arriba:
window.scrollBy(0, -window.innerHeight);
Utilizando opciones:
window.scrollBy({ top: 100, left: 100, behaviour: 'smooth' })
Notas
window.scrollBy desplaza el documento una cantidad determinada, mientras que window.scroll lo hace hacia una posición absoluta en el documento. Vea también window.scrollByLines, window.scrollByPages
Especificación
Especificación | Estado | Comentarios |
---|---|---|
CSS Object Model (CSSOM) View Module La definición de 'window.scrollBy()' en esta especificación. |
Working Draft | Definición inicial. |