Window: scrollX 屬性

Baseline 廣泛可用 *

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

* 此特性的某些部分可能存在不同級別的支援。

Window 介面的只讀屬性 scrollX 返回文件當前水平滾動的畫素數。在現代瀏覽器中,此值是亞畫素精度的,也就是說它不一定是整數。您可以透過 scrollY 屬性獲取文件垂直滾動的畫素數。

一個雙精度浮點數值,表示文件當前從原點水平滾動的畫素數,正值表示內容向右滾動(顯示更多右側內容)。更專業地說,scrollX 返回當前 視口 左邊緣的 X 座標。如果文件根本沒有左右滾動,則 scrollX 為 0。如果沒有視口,則返回值為 0。如果文件在亞畫素精度裝置上渲染,則返回值也是亞畫素精度的,可能包含小數部分。

注意:如果您需要一個整數值,可以使用 Math.round() 對其進行四捨五入。

如果文件可以從初始包含塊向左滾動,scrollX 可能為負值。例如,如果文件是從右到左顯示並且內容向左增長。

Safari 透過更新大於最大滾動位置的 scrollX 來響應過度滾動(除非停用了預設的“反彈”效果,例如透過將 overscroll-behavior 設定為 none),而 Chrome 和 Firefox 則不會。

此屬性是隻讀的。要將視窗滾動到特定位置,請使用 Window.scroll()

示例

此示例檢查文件當前的水平滾動位置。如果大於 400 畫素,則將視窗滾動回開頭。

js
if (window.scrollX > 400) {
  window.scroll(0, 0);
}

注意

pageXOffset 屬性是 scrollX 屬性的別名。這意味著如果您沒有重新分配這兩個屬性中的任何一個,window.pageXOffset === window.scrollX 始終為 true。

規範

規範
CSSOM 檢視模組
# dom-window-scrollx

瀏覽器相容性

另見