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

浏览器兼容性