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 滚动指定的距离,而 window.scroll 滚动至文档中的绝对位置。另外还有 window.scrollByLines, window.scrollByPages

规范

规范 状态 说明
CSS Object Model (CSSOM) View Module
window.scrollBy()
Working Draft 初次定义