Window: scrollTo() 方法

Baseline 已廣泛支援

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

Window.scrollTo() 方法可滾動到文件中的特定座標集。

語法

js
scrollTo(xCoord, yCoord)
scrollTo(options)

引數

xCoord

文件水平軸上的畫素,您希望顯示在左上角。

yCoord

文件垂直軸上的畫素,您希望顯示在左上角。

options

包含以下屬性的物件:

top

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

left

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

behavior

確定滾動是即時發生的還是平滑動畫的。此選項是一個字串,必須是以下值之一

  • smooth:滾動應該平滑動畫。
  • instant:滾動應該即時發生,一次性跳轉。
  • auto:滾動行為由 scroll-behavior 的計算值決定。

返回值

無(undefined)。

示例

js
window.scrollTo(0, 1000);

使用 options

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

注意

Window.scroll() 與此方法基本相同。對於相對滾動,請參閱 Window.scrollBy()Window.scrollByLines()Window.scrollByPages()

有關滾動元素,請參閱 Element.scrollTopElement.scrollLeft

規範

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

瀏覽器相容性