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	微信小程序	H5	React Native
Taro.pageScrollTo	✔️	✔️