Window: scrollTo() 方法

Window.scrollTo() 将滚动到文档中一组特定的坐标。

语法

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

参数

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

- 或 -

选项

包含以下参数的字典

顶部

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

left

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

behavior

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

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

返回值

无 (undefined).

示例

js
window.scrollTo(0, 1000);

使用 options

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

注释

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

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

规范

规范
CSSOM View Module
# dom-window-scrollto

浏览器兼容性

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