• 下载
  • 社区

my.pageScrollTo

滚动到页面的目标位置。


注意:

  • scrollTop的优先级比selector高。
  • 使用 my.pageScrollTo 跳转小程序顶部时,必须将 scrollTop 值设为大于 0,方可实现跳转。


扫码体验

滚动.jpeg


效果示例


滚动.gif


示例代码

<!-- API-DEMO page/API/page-scroll-to/page-scroll-to.axml-->
<view class="page">
  <view class="page-description">页面滚动 API</view>

  <view class="page-section">
    <view class="page-section-title">
      my.pageScrollTo
    </view>
    <view class="page-section-demo">
      <input type="text" placeholder="key" name="key" value="{{scrollTop}}" onInput="scrollTopChange"></input>
    </view>
    <view class="page-section-btns">
      <view onTap="scrollTo">页面滚动</view>
    </view>
  </view>

  <view style="height:1000px"/>
</view>


// API-DEMO page/API/page-scroll-to/page-scroll-to.js
Page({
  data: {
    scrollTop: 0,
  },
  scrollTopChange(e) {
    this.setData({
      scrollTop: e.detail.value,
    });
  },
  onPageScroll({ scrollTop }) {
    console.log('onPageScroll', scrollTop);
  },
  scrollTo() {
    my.pageScrollTo({
      scrollTop: parseInt(this.data.scrollTop),
            duration: 300,
    });
  },
});


入参

为 Object 类型,属性如下:


属性

类型

默认值

必填

描述

最低版本

scrollTop

Number

-

滚动到页面的目标位置,单位 px。使用 my.pageScrollTo 跳转小程序顶部时,必须将 scrollTop 值设为大于 0,方可实现跳转。


duration

Number

0

滚动动画的时长,单位ms

1.20.0

selector

string

-

选择器

1.20.0

success

function

-

接口调用成功的回调函数


fail

function

-

接口调用失败的回调函数


complete

function

-

接口调用结束的回调函数(调用成功、失败都会执行



selector语法

当传入 selector 参数,框架会执行 document.querySelector(selector) 以选取目标节点。