元素:scrollTo() 方法

scrollTo()Element 接口的方法,用于滚动到给定元素内部的特定坐标集。

语法

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

参数

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

- 或 -

选项

包含以下参数的字典

顶部

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

左边

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

行为

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

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

返回值

无 (undefined)。

示例

js
element.scrollTo(0, 1000);

使用options

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

规范

规范
CSSOM 视图模块
# dom-element-scrollto

浏览器兼容性

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

另请参阅