• JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 交互反馈
  • 导航栏
  • 菜单
  • 动画
  • 页面位置
  • tt.pageScrollTo
  • 滑动返回
  • 下拉刷新
  • 键盘
  • TabBar
  • 页面导航
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • tt.pageScrollTo
    收藏
    我的收藏

    基础库 1.0.0 开始支持本方法,这是一个异步方法。

    滚动当前展示页面(页面栈处于最上层)到目标位置,支持滚动距离和选择器两种方式定位,滚动距离优先级高于选择器。

    前提条件
    业务背景
    使用限制
    如果页面元素没有超过一屏,无法实现页面滚动。
    注意事项
    如果在 A 页面通过定时器延迟调用, 那么当定时器触发时当前栈顶页面是 B 则滚动的是 B 页面。
    支持沙盒
    相关教程

    语法

    tt.pageScrollTo(options)

    参数说明

    options 为 object 类型,属性如下:

    属性名类型默认值必填说明最低支持版本
    selectorstring
    选择器,用于定位要滚动到的目标元素,支持标准 css 选择器语法
    2.62.0
    offsetTopnumber0
    偏移距离,需要和 selector 参数搭配使用,可以滚动到 selector 加偏移距离的位置,单位 px
    2.62.0
    durationnumber200
    动画的执行时长,单位 ms
    1.0.0
    scrollTopnumber
    滚动到页面的目标位置,单位 px
    1.0.0
    successfunction
    接口调用成功的回调函数
    1.0.0
    failfunction
    接口调用失败的回调函数
    1.0.0
    completefunction
    接口调用结束的回调函数(调用成功、失败都会执行)
    1.0.0

    回调成功

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "pageScrollTo:ok"
    1.0.0

    回调失败

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "pageScrollTo:fail" + 详细错误信息
    1.0.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例