my.pagescrollto(object object)
小程序开发者工具： 支持。
主体： 企业支付宝小程序 、 个人支付宝小程序
相关文档： native 渲染
将页面滚动到目标位置。
支持滚动距离（scrolltop）和选择器两种方式定位，滚动距离优先级高于选择器。
object object
查看示例
| 属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
|---|---|---|---|---|---|
| scrolltop | number | - | 否 | - | 滚动到页面的目标位置，单位 px，scrolltop 的优先级比 selector 高 |
| duration | number | 0 | 否 | 基础库: 1.20.0/2.6.0 |
滚动动画的时长，单位 ms |
| selector | string | - | 否 | 基础库: 1.20.0/2.6.0 |
css 选择器。框架会执行 document.queryselector(selector) 以选取目标节点，支持符合标准的 css 选择器语法，以为参考 |
| offsettop | number | - | 否 | 基础库: 2.8.0 |
偏移距离，需要和 selector 参数搭配使用，可以滚动到 selector 加偏移距离的位置，单位 px |
| success | function | - | 否 | - | 调用成功的回调函数 |
| fail | function | - | 否 | - | 调用失败的回调函数 |
| complete | function | - | 否 | - | 调用结束的回调函数（调用成功、失败都会执行） |
fail 回调的参数为 object，error 属性为错误码，errormessage 属性为错误消息。
| 错误码 | 错误消息 | 凯发app官方网站的解决方案 |
|---|---|---|
| 1 | need scrolltop or selector |
缺少 scrolltop 或者 selector 参数，scrolltop 与 selector 必须传入一个。 |
在线示例
代码示例
扫码体验
pagescrollto js 代码
my.pagescrollto({
scrolltop: 1000,
duration: 0,
success: (res) => {
console.log(res)
},
fail: (error) => {
console.log(error)
}
});
q：为什么调用 my.pagescrollto 页面没有滚动？
a：
一般来说可从以下两个方面排查：
- 请检查期望滚动行为是否在 scroll-view 等组件内。my.pagescrollto 是页面滚动的 api。
- 请检查最外层容器元素是否同时设置了 { height: 100vh; overflow-y: auto } 这两个样式，此样式会导致 my.pagescrollto 滚动失效。
q：my.pagescrollto 支持跨自定义组件的后代选择器吗？
a：
目前 my.pagescrollto 只支持标准的 css 选择器。