Метод Window: scrollBy()

Базовая поддержка Широко поддерживается

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с сентября 2020 года.

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

Синтаксис

scrollBy(xCoord, yCoord)
scrollBy(options)

Параметры

xCoord

Значение в пикселях по горизонтали, на которое нужно сдвинуть.

yCoord

Значение в пикселях по вертикали, на которое нужно сдвинуть.

options

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

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

Возвращаемое значение

Ничего (undefined).

Примеры

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

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().

Спецификации

Спецификация
CSSOM View Module # dom-window-scrollby

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`scrollBy`	1	12	1	3	1	18	4	10.1	1	1.0	4.4
`options_behavior_parameter`	61	79	36	48	14 Safari не поддерживает поведение скролла `smooth`.	61	36	45	14 Safari на iOS не поддерживает поведение скролла `smooth`.	8.0	61
`options_left_parameter`	41	79	36	28	10.1	41	36	28	10.3	4.0	41
`options_top_parameter`	41	79	36	28	10.1	41	36	28	10.3	4.0	41

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Window/scrollBy