Window.scrollY

Этот перевод не завершён. Пожалуйста, помогите перевести эту статью с английского

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

Синтаксис

var y = window.scrollY

Значение

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

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

Говоря технически, то scrollY возвращает Y-координату от верхнего края текущего окна просмотра (viewport). Если окна просмотра нет, то возвращаемое значение = 0.

Пример

// проверить и перейти ко второй странице
if (window.scrollY) {
  window.scroll(0, 0);  // Обнулите позицию пролистывания на левый верхний угол документа.
}

window.scrollByPages(1);

Заметки

Применяйте данное свойство для проверки, был ли пролистан документ, когда используете похожие функции для работы с пролистыванием, такие как scrollBy(), scrollByLines(), or scrollByPages().

Свойство pageYOffset - другое название свойства scrollY :

window.pageYOffset == window.scrollY; // всегда верно

Для кросс-браузерной совместимости используйте window.pageYOffset вместо window.scrollY. Кроме того, старые версии Internet Explorer (<9) не поддерживают оба свойства. Для работы в Internet Explorer необходимо использовать нестандарные свойства. Пример полностью совместимого со всеми браузерами кода:

var supportPageOffset = window.pageXOffset !== undefined;
var isCSS1Compat = ((document.compatMode || "") === "CSS1Compat");

var x = supportPageOffset ? window.pageXOffset : isCSS1Compat ? document.documentElement.scrollLeft : document.body.scrollLeft;
var y = supportPageOffset ? window.pageYOffset : isCSS1Compat ? document.documentElement.scrollTop : document.body.scrollTop;

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

Спецификации Статус Комментарий
CSS Object Model (CSSOM) View Module
Определение 'window.scrollY' в этой спецификации.
Рабочий черновик

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

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung Internet
scrollYChrome Полная поддержка 1
Полная поддержка 1
Полная поддержка 1
Альтернативное имя
Альтернативное имя Использует нестандартное имя: pageYOffset
Edge Полная поддержка 12
Полная поддержка 12
Полная поддержка 12
Альтернативное имя
Альтернативное имя Использует нестандартное имя: pageYOffset
Firefox Полная поддержка 1
Полная поддержка 1
Полная поддержка 1
Альтернативное имя
Альтернативное имя Использует нестандартное имя: pageYOffset
IE Полная поддержка 9
Альтернативное имя
Полная поддержка 9
Альтернативное имя
Альтернативное имя Использует нестандартное имя: pageYOffset
Opera Полная поддержка 9.6
Полная поддержка 9.6
Полная поддержка 4
Альтернативное имя
Альтернативное имя Использует нестандартное имя: pageYOffset
Safari Полная поддержка 1
Полная поддержка 1
Полная поддержка 1
Альтернативное имя
Альтернативное имя Использует нестандартное имя: pageYOffset
WebView Android Полная поддержка 1
Полная поддержка 1
Полная поддержка 1
Альтернативное имя
Альтернативное имя Использует нестандартное имя: pageYOffset
Chrome Android Полная поддержка 18
Полная поддержка 18
Полная поддержка 18
Альтернативное имя
Альтернативное имя Использует нестандартное имя: pageYOffset
Firefox Android Полная поддержка 4
Полная поддержка 4
Полная поддержка 4
Альтернативное имя
Альтернативное имя Использует нестандартное имя: pageYOffset
Opera Android Полная поддержка 10.1
Полная поддержка 10.1
Полная поддержка 10.1
Альтернативное имя
Альтернативное имя Использует нестандартное имя: pageYOffset
Safari iOS Полная поддержка 1
Полная поддержка 1
Полная поддержка 1
Альтернативное имя
Альтернативное имя Использует нестандартное имя: pageYOffset
Samsung Internet Android Полная поддержка 1.0
Полная поддержка 1.0
Полная поддержка 1.0
Альтернативное имя
Альтернативное имя Использует нестандартное имя: pageYOffset
Subpixel precisionChrome Полная поддержка ДаEdge Полная поддержка ≤18Firefox Полная поддержка 55IE Нет поддержки НетOpera Полная поддержка ДаSafari Полная поддержка ДаWebView Android Полная поддержка ДаChrome Android Полная поддержка ДаFirefox Android Полная поддержка 55Opera Android ? Safari iOS ? Samsung Internet Android Полная поддержка Да

Легенда

Полная поддержка  
Полная поддержка
Нет поддержки  
Нет поддержки
Совместимость неизвестна  
Совместимость неизвестна
Использует нестандартное имя.
Использует нестандартное имя.

См. также