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 июль 2015 г..

* Some parts of this feature may have varying levels of support.

Learn more
See full compatibility

Метод Window.scrollBy() прокручивает документ в окне на указанную величину.

Синтаксис

scrollBy(x-coord, y-coord)
scrollBy(options)

Параметры

x-coord смещение в пикселях по горизонтали.
y-coord смещение в пикселях по вертикали.

- или -

options

Объект, содержащий следующие свойства:

top: Указывает количество пикселей по оси Y для прокрутки окна или элемента.
left: Указывает количество пикселей по оси X для прокрутки окна или элемента.
behavior: Указывает, нужно ли анимировать прокрутку плавно (smooth), быстрым перемещением (instant) или предоставить выбор браузеру (auto, по умолчанию).

Примеры

Для прокрутки вниз страницы:

window.scrollBy(0, window.innerHeight);

Для прокрутки вверх:

window.scrollBy(0, -window.innerHeight);

С использованием options:

window.scrollBy({
  top: 100,
  left: 100,
  behavior: "smooth",
});

window.scrollBy() прокручивает страницу на указанное количество пикселей, в то время как метод window.scroll() прокручивает к абсолютной позиции в документе. Смотрите также window.scrollByLines() и window.scrollByPages().