Element: scrollTo() 方法

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流浏览器均已支持。

Element 接口的 scrollTo() 方法可以在给定元素内滚动到指定的坐标。

语法

js
scrollTo(xCoord, yCoord)
scrollTo(options)

参数

xCoord

您希望显示在左上角的元素的水平轴上的像素值。

yCoord

您希望显示在左上角的元素的垂直轴上的像素值。

options

包含以下属性的对象:

top

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

left

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

behavior

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

  • 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

浏览器兼容性

另见