dlt.pageScrollTo

简介

将页面滚动到目标位置。

参数

Object object

属性	类型	默认值	必填	说明
scrollTop	number		否	滚动到页面的目标位置（单位：px）
selector	string		否	选择器
duration	number	300	否	滚动动画的时长（单位: ms）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

Object res

属性	类型	说明
errMsg	string	"ok" - 调用成功

object.fail 回调函数

参数

Object res

属性	类型	说明
errMsg	number	-1 - 调用失败

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

注意 📢：使用 selector 选择器来指定滚动的目标时，就不要再设置 scrollTop 了，会以 selector 为准。

示例代码

// pages/index/index.js
Page({
  pageScrollTo() {
    dlt.pageScrollTo({
      scrollTop: 0,
      duration: 1000,
      success: function () {
        console.log('success');
      },
      fail: function () {
        console.log('fail');
      },
      complete: function () {
        console.log('complete');
      },
    });
  },
});