Spec-Zone.ru › Web APIs

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

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

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

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

Метод scrollBy() интерфейса Element прокручивает элемент на заданное количество пикселей.

Синтаксис

scrollBy(xCoord, yCoord)
scrollBy(options)

Параметры

xCoord

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

yCoord

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

options

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

top

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

left

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

behavior

Указывает, должна ли прокрутка происходить плавно (smooth), мгновенно (instant) или браузер сам выбирает (auto, по умолчанию).

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

None (undefined).

Примеры

// scroll an element
element.scrollBy(300, 300);

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

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

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

Спецификация
Модуль CSSOM View
# dom-element-scrollby

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
scrollBy 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

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

Spec-Zone.ru

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