Окно: свойство scrollY

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

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

* Некоторые части этой функции могут иметь разную степень поддержки.

Только для чтения scrollY свойство интерфейса Window возвращает количество пикселей, на которое документ в настоящее время прокручен вертикально. Это значение имеет субпиксельную точность в современных браузерах, что означает, что это не обязательно целое число. Количество пикселей, на которое документ прокручен по горизонтали, можно получить из свойства scrollX.

Значение

Значение с двойной точностью, указывающее количество пикселей, на которое документ в настоящее время прокручен вертикально от начала координат, где положительное значение означает, что содержимое прокручено вниз (чтобы отобразить больше содержимого внизу). В более технических терминах, scrollY возвращает координату Y верхнего края текущего viewport. Если документ вообще не прокручен вверх или вниз, то scrollY равно 0. Если viewport отсутствует, возвращаемое значение равно 0. Если документ отображается на устройстве с субпиксельной точностью, возвращаемое значение также имеет субпиксельную точность и может содержать дробную часть.

Примечание: Если вам нужно целое число, вы можете использовать Math.round() для его округления.

Safari реагирует на перепрокрутку, обновляя scrollY за пределы максимальной позиции прокрутки (если эффект «отскока» по умолчанию отключён, например, путём установки overscroll-behavior на значение none), в то время как Chrome и Firefox нет. Например, scrollY может быть отрицательным в Safari просто за счёт продолжения прокрутки вверх, когда документ уже находится вверху.

Это свойство является только для чтения. Чтобы прокрутить окно до определённой позиции, используйте Window.scroll().

Примеры

// make sure and go down to the second page
if (window.scrollY) {
  window.scroll(0, 0); // reset the scroll position to the top left of the document.
}

window.scrollByPages(1);

Примечания

Используйте это свойство для проверки того, что документ ещё не прокручен при использовании функций прокрутки с относительными значениями, таких как scrollBy(), scrollByLines() или scrollByPages().

Свойство pageYOffset является псевдонимом для свойства scrollY. Это означает, что если вы не переопределили ни одно из свойств, window.pageYOffset === window.scrollY всегда истинно.

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

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

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`scrollY`	11	1212	11	9.64	11	1818	44	10.110.1	11	1.01.0	4.44.4
`subpixel_precision`	40	≤18	55	27	Нет	40	55	27	Нет	4.0	40

См. также

window.scrollX

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