Метод 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