Element.scrollTo()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

ElementscrollTo() 方法可以使界面滚动到给定元素的指定坐标位置。

语法

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

参数

  • x-coord 是你想要显示在左上角的元素沿水平轴的像素。
  • y-coord 是你想要显示在左上角的元素沿垂直轴的像素。

- 或者 -

options

包含以下参数的对象:

top

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

left

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

behavior

smooth 表示平滑滚动并产生过渡效果、instant 表示滚动会直接跳转到目标位置,没有过渡效果。auto 或缺省值表示浏览器会自动选择滚动时的过渡效果。

返回值

无 (undefined)。

示例

js
element.scrollTo(0, 1000);

使用 options:

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

规范

Specification
CSSOM View Module
# dom-element-scrollto

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
scrollTo
options.behavior parameter
options.left parameter
options.top parameter

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

参见