Version: 2.2.1
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 | ✔️ | ✔️ |