Window: scroll() 方法

Window.scroll() 方法将窗口滚动到文档中的特定位置。

语法

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

参数

  • x-coord 是您希望在左上角显示的文档水平轴上的像素。
  • y-coord 是您希望在左上角显示的文档垂直轴上的像素。

- 或 -

选项

包含以下参数的字典

top

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

left

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

behavior

确定滚动是立即发生还是平滑动画。此选项是一个字符串,必须采用以下值之一

  • smooth:滚动应平滑动画
  • instant:滚动应立即以一次跳跃发生
  • auto:滚动行为由 scroll-behavior 的计算值确定

返回值

无 (undefined)。

示例

html
<!-- put the 100th vertical pixel at the top of the window -->

<button onclick="scroll(0, 100);">click to scroll to the 100th pixel</button>

使用options

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

注释

Window.scrollTo() 与此方法实际上相同。对于相对滚动,请参阅 Window.scrollBy()Window.scrollByLines()Window.scrollByPages()

对于滚动元素,请参阅 Element.scrollTopElement.scrollLeft

规范

规范
CSSOM 视图模块
# dom-window-scroll

浏览器兼容性

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

另请参阅