Version: next

Taro.pageScrollTo(option)

将页面滚动到目标位置,支持选择器和滚动距离两种方式定位

selector 语法 selector类似于 CSS 的选择器,但仅支持下列语法。

  • ID选择器:#the-id
  • class选择器(可以连续指定多个):.a-class.another-class
  • 子元素选择器:.the-parent > .the-child
  • 后代选择器:.the-ancestor .the-descendant
  • 跨自定义组件的后代选择器:.the-ancestor >>> .the-descendant
  • 多选择器的并集:#a-node, .some-other-nodes

参考文档

类型

(option: Option) => void

参数

Option

参数类型必填说明
complete
(res: CallbackResult) => void
接口调用结束的回调函数(调用成功、失败都会执行)
duration
number
滚动动画的时长,单位 ms
fail
(res: CallbackResult) => void
接口调用失败的回调函数
scrollTop
number
滚动到页面的目标位置,单位 px
selector
string
选择器, css selector
success
(res: CallbackResult) => void
接口调用成功的回调函数

示例代码

Taro.pageScrollTo({
scrollTop: 0,
duration: 300
})

API 支持度

API微信小程序H5React Native
Taro.pageScrollTo✔️✔️