Element: scrollTo() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流瀏覽器均已支援。

Element 介面的 scrollTo() 方法可以在給定元素內滾動到指定的座標。

語法

js
scrollTo(xCoord, yCoord)
scrollTo(options)

引數

xCoord

您希望顯示在左上角的元素的水平軸上的畫素值。

yCoord

您希望顯示在左上角的元素的垂直軸上的畫素值。

options

包含以下屬性的物件:

top

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

left

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

behavior

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

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

返回值

無(undefined)。

示例

js
element.scrollTo(0, 1000);

使用 options

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

規範

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

瀏覽器相容性

另見