swan.pageScrollTo

解释:将页面滚动到目标位置(可以设置滚动动画时长)。

方法参数

Object object

object参数说明

属性名类型必填默认值说明
scrollTopNumber滚动到页面的目标位置(单位 px)
durationNumber300滚动动画的时长,(单位 ms)
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

示例

扫码体验

位置 swan.pageScrollTo - 图1请使用百度APP扫码

代码示例1 - 页面滚动到顶部

在开发者工具中预览效果

  1. <view class="container">
  2. <image class="image" src="https://b.bdstatic.com/miniapp/images/longImage.png"></image>
  3. <view class="swan-security-padding-bottom flex-button">
  4. <button type="primary" bindtap="scrollToTop">返回顶部</button>
  5. </view>
  6. </view>
  1. Page({
  2. scrollToTop() {
  3. swan.pageScrollTo({
  4. scrollTop: 0,
  5. duration: 300,
  6. success: res => {
  7. console.log('pageScrollTo success', res);
  8. },
  9. fail: err => {
  10. console.log('pageScrollTo fail', err);
  11. }
  12. });
  13. }
  14. });

代码示例2 - 页面滚动到底部

在开发者工具中预览效果

  1. <view class="container">
  2. <image class="image" src="https://b.bdstatic.com/miniapp/images/longImage.png"></image>
  3. <view class="swan-security-padding-bottom flex-button">
  4. <button type="primary" bindtap="scrollToBottom">滚动到页面底部</button>
  5. </view>
  6. </view>
  1. Page({
  2. scrollToBottom(){
  3. swan.createSelectorQuery()
  4. .select(".image")
  5. .boundingClientRect(function(rect) {
  6. swan.pageScrollTo({
  7. scrollTop: rect.bottom,
  8. duration: 300,
  9. success: res => {
  10. console.log('pageScrollTo success', res);
  11. },
  12. fail: err => {
  13. console.log('pageScrollTo fail', err);
  14. }
  15. });
  16. })
  17. .exec();
  18. }
  19. });

错误码

Android

错误码说明
202解析失败,请检查参数是否正确
1001执行失败

iOS

错误码说明
202解析失败,请检查参数是否正确