Spec-Zone.ru › Web APIs

Метод Window: scrollTo()

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

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

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Window.scrollTo() прокручивает документ до определённых координат.

Синтаксис

scrollTo(xCoord, yCoord)
scrollTo(options)

Параметры

xCoord

Пиксель по горизонтали документа, который должен отображаться в верхнем левом углу.

yCoord

Пиксель по вертикали документа, который должен отображаться в верхнем левом углу.

options

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

top

Указывает количество пикселей по оси Y для прокрутки окна или элемента.

left

Указывает количество пикселей по оси X для прокрутки окна или элемента.

behavior

Определяет, будет ли прокрутка мгновенной или плавной. Это строковое значение, которое должно принимать одно из следующих значений:

  • smooth: прокрутка должна быть плавной
  • instant: прокрутка должна произойти мгновенно в один прыжок
  • auto: поведение прокрутки определяется вычисленным значением scroll-behavior

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

None (undefined).

Примеры

window.scrollTo(0, 1000);

Используя options:

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

Примечания

Window.scroll() по сути то же самое, что и этот метод. Для относительной прокрутки см. Window.scrollBy(), Window.scrollByLines() и Window.scrollByPages().

Для прокрутки элементов см. Element.scrollTop и Element.scrollLeft.

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

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

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
scrollTo 1 12 1 4 1 18 4 10.1 1 1.0 4.4
options_behavior_parameter 61 79 36 48
14До версии 15.4 в Safari не поддерживалось поведение прокрутки smooth.
61 36 45
14До версии 15.4 в 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/scrollTo

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API