Appearance
qin.pageScrollTo(OBJECT)
将页面滚动到目标位置。可以指定滚动到具体的scrollTop数值,也可以指定滚动到某个元素的位置
平台差异说明
| H5 | 微信小程序 | 小红书小程序 | 抖音小程序 | 快手快应用 |
|---|---|---|---|---|
| √ | √ | √ | √ | √ |
OBJECT 参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| scrollTop | Number | 否 | 滚动到页面的目标位置(单位 px) |
| selector | String | 否 | 元素选择器,用于指定要滚动到的元素位置,H5 、微信小程序2.7.3+ 、支付宝小程序1.20.0+支持 |
| duration | Number | 否 | 滚动动画的时长,默认 300ms ,单位 ms |
| success | function | 否 | 接口调用成功的回调函数 |
| fail | function | 否 | 接口调用失败的回调函数 |
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
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
示例
js
qin.pageScrollTo({
scrollTop: 0,
duration: 300,
});qin.pageScrollTo({
scrollTop: 0,
duration: 300,
});