Element:scrollBy() 方法

Baseline 已廣泛支援

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

Element 介面的 scrollBy() 方法可按給定量滾動元素。

語法

js
scrollBy(xCoord, yCoord)
scrollBy(options)

引數

xCoord

您希望水平滾動的畫素值。

yCoord

您希望垂直滾動的畫素值。

options

包含以下屬性的物件:

top

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

left

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

behavior

指定滾動應該是平滑動畫(smooth)、一次性瞬間跳轉(instant)還是讓瀏覽器自行選擇(auto,預設值)。

返回值

無(undefined)。

示例

js
// scroll an element
element.scrollBy(300, 300);

使用 options

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

規範

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

瀏覽器相容性