Окно: свойство scrollX
Базовая Широко доступно *
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с сентября 2020 года.
* Некоторые части этой функции могут иметь различный уровень поддержки.
Только для чтения scrollX свойство интерфейса Window возвращает количество пикселей, на которое документ в настоящее время прокручен по горизонтали. Это значение имеет точность до дробных частей пикселя в современных браузерах, что означает, что оно не обязательно является целым числом. Количество пикселей, на которое документ прокручен по вертикали, можно получить из свойства scrollY.
Значение
Значение с двойной точностью, указывающее количество пикселей, на которое документ в настоящее время прокручен по горизонтали от начала координат, где положительное значение означает, что содержимое прокручено вправо (чтобы показать больше содержимого справа). В более технических терминах, scrollX возвращает координату X левого края текущего viewport. Если документ не прокручен ни влево, ни вправо, то scrollX равно 0. Если viewport отсутствует, возвращаемое значение равно 0. Если документ отображается на устройстве с точностью до дробных частей пикселя, то возвращаемое значение также имеет точность до дробных частей пикселя и может содержать десятичную часть.
Примечание: Если вам нужно целое значение, вы можете использовать Math.round(), чтобы округлить его.
Возможным является, что scrollX может быть отрицательным, если документ можно прокрутить влево от начального содержащего блока. Например, если документ имеет направление справа налево, а содержимое растёт влево.
Safari реагирует на перепрокрутку, обновляя scrollX за пределы максимальной позиции прокрутки (если эффект "отскока" по умолчанию отключён, например, путем задания overscroll-behavior в значение none), в то время как Chrome и Firefox этого не делают.
Это свойство является только для чтения. Чтобы прокрутить окно в определённое место, используйте Window.scroll().
Примеры
В этом примере проверяется текущая горизонтальная позиция прокрутки документа. Если она больше 400 пикселей, окно прокручивается обратно к началу.
if (window.scrollX > 400) {
window.scroll(0, 0);
}
Примечания
Свойство pageXOffset является псевдонимом для свойства scrollX. Это означает, что если ни одно из свойств не переопределено, то window.pageXOffset === window.scrollX всегда истинно.
Спецификации
| Спецификация |
|---|
| CSSOM View Module # dom-window-scrollx |
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari в IOS | Samsung Internet | WebView Android | |
scrollX |
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 |
См. также
© 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/scrollX