Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.

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 smoothinstant, 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.

Etiquetas y colaboradores del documento

Colaboradores en esta página: plaso, Bcd
Última actualización por: plaso,