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

浏览器兼容性