Window.scrollBy()
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.
* Some parts of this feature may have varying levels of support.
Resumen
Desplaza el documento el número de pixels proporcionados.
Sintaxis
js
window.scrollBy(X, Y);
window.scrollBy(opciones);
Parámetros
Xes el número de pixels a desplazar horizontalmente.Yes 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 -
opcioneses un objeto con tres posibles propiedades:top, que es lo mismo queYleft, que es lo mismo queXbehavior, que es un string cuyo valor puede ser smooth, instant, or auto. Por defecto el valor esauto
Ejemplo
js
// Desplazarse la longitud de una página
window.scrollBy(0, window.innerHeight);
Para hacer scroll hacia arriba:
js
window.scrollBy(0, -window.innerHeight);
Utilizando opciones:
js
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
Especificaciones
| Specification |
|---|
| CSSOM View Module # dom-window-scrollby |