元素:scroll() 方法

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

语法

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

参数

x-coord

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

y-coord

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

- 或 -

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

浏览器兼容性

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