Spec-Zone.ru › Web APIs

Окно: метод scroll()

Базовая линия Широко доступно

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

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

Метод Window.scroll() прокручивает окно до определённого места в документе.

Синтаксис

scroll(xCoord, yCoord)
scroll(options)

Параметры

xCoord

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

yCoord

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

options

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

top

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

left

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

behavior

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

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

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

Ничего (undefined).

Примеры

<!-- put the 100th vertical pixel at the top of the window -->

<button onclick="scroll(0, 100);">click to scroll to the 100th pixel</button>

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

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

Примечания

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

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

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

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

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

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

См. также

  • Window.scrollByLines()
  • Window.scrollByPages()
  • Element.scrollIntoView()

© 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/scroll

Spec-Zone.ru

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