Spec-Zone.ru › Web APIs

Элемент: метод scrollTo()

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

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

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

Метод scrollTo() интерфейса Element прокручивает содержимое до определённых координат внутри заданного элемента.

Синтаксис

scrollTo(xCoord, yCoord)
scrollTo(options)

Параметры

xCoord

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

yCoord

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

options

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

top

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

left

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

behavior

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

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

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

None (undefined).

Примеры

element.scrollTo(0, 1000);

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

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

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

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

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
scrollTo 61 79 36 48 10.1 61 36 45 10.3 8.0 61
options_behavior_parameter 61 79 36 48 14 61 36 45 14 8.0 61
options_left_parameter 61 79 36 48 10.1 61 36 45 10.3 8.0 61
options_top_parameter 61 79 36 48 10.1 61 36 45 10.3 8.0 61

См. также

  • Element.scrollTop, Element.scrollLeft
  • Window.scrollTo()

© 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/Element/scrollTo

Spec-Zone.ru

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