Window.scrollBy()

摘要

在窗口中按指定的偏移量滚动文档。

语法

window.scrollBy(x-coord, y-coord);
window.scrollBy(options)

参数

  • X 是水平滚动的偏移量，单位：像素。
  • Y 是垂直滚动的偏移量，单位：像素。

正数坐标会朝页面的右下方滚动，负数坐标会滚向页面的左上方。

  • options 是一个包含三个属性的对象：
  1. top 等同于 y-coord
  2. left 等同于 x-coord
  3. behavior 表示滚动行为，支持参数：smooth (平滑滚动)，instant (瞬间滚动)，默认值 auto，效果等同于 instant

例子

向下滚动一页：

window.scrollBy(0, window.innerHeight);

向上滚动一页：

window.scrollBy(0, -window.innerHeight);

使用 options：

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

注意

window.scrollBy (en-US) 滚动指定的距离，而 window.scroll (en-US) 滚动至文档中的绝对位置。另外还有 window.scrollByLines (en-US), window.scrollByPages

规范

Specification
CSSOM View Module
# dom-window-scrollby