Window: scrollBy() 方法

Window.scrollBy() 方法根据给定的量滚动窗口中的文档。

语法

js
scrollBy(x-coord, y-coord)
scrollBy(options)

参数

  • x-coord 是您要水平滚动的像素值。
  • y-coord 是您要垂直滚动的像素值。

- 或 -

选项

包含以下参数的字典

top

指定沿 Y 轴滚动窗口或元素的像素数。

left

指定沿 X 轴滚动窗口或元素的像素数。

行为

指定滚动是否应平滑动画 (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

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。