Window:scrollBy() 方法

Baseline 已廣泛支援

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

Window.scrollBy() 方法可以按指定量滾動視窗中文件。

語法

js
scrollBy(xCoord, yCoord)
scrollBy(options)

引數

xCoord

您想要水平滾動的畫素值。

yCoord

您想要垂直滾動的畫素值。

options

包含以下屬性的物件:

top

指定要滾動視窗或元素的 Y 軸上的畫素數。

left

指定要滾動視窗或元素的 X 軸上的畫素數。

behavior

指定滾動是應平滑動畫(smooth)、立即進行單次跳轉(instant)還是由瀏覽器選擇(auto,預設值)。

返回值

無(undefined)。

示例

向下滾動一頁

js
window.scrollBy(0, window.innerHeight);

向上滾動

js
window.scrollBy(0, -window.innerHeight);

使用 options

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

注意

window.scrollBy() 按特定量滾動,而 window.scroll() 滾動到文件中的絕對位置。另請參閱 window.scrollByLines()window.scrollByPages()

規範

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

瀏覽器相容性