Element: scroll() 方法

Baseline 已广泛支持

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

Element 接口的 scroll() 方法可以将元素滚动到指定元素内的一组特定坐标。

语法

js
scroll(xCoord, yCoord)
scroll(options)

参数

xCoord

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

yCoord

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

options

包含以下属性的对象:

top

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

left

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

behavior

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

  • smooth:滚动应该平滑动画。
  • instant:滚动应该即时发生,一次性跳转。
  • auto:滚动行为由 scroll-behavior 的计算值决定。

返回值

无(undefined)。

示例

js
// Put the 1000th vertical pixel at the top of the element
element.scroll(0, 1000);

使用 options

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

规范

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

浏览器兼容性