title: Taro.pageScrollTo(option)

sidebar_label: pageScrollTo

将页面滚动到目标位置，支持选择器和滚动距离两种方式定位

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

支持情况：pageScrollTo - 图1 pageScrollTo - 图2 pageScrollTo - 图3

参考文档

类型

  1. (option: Option) => Promise<TaroGeneral.CallbackResult>

参数

参数 类型
option Option

Option

参数 类型 必填 说明
complete (res: TaroGeneral.CallbackResult) => void 否 接口调用结束的回调函数（调用成功、失败都会执行）
duration number 否 滚动动画的时长，单位 ms
fail (res: TaroGeneral.CallbackResult) => void 否 接口调用失败的回调函数
scrollTop number 否 滚动到页面的目标位置，单位 px
selector string 否 选择器, css selector
success (res: TaroGeneral.CallbackResult) => void 否 接口调用成功的回调函数

示例代码

  1. Taro.pageScrollTo({
  2.   scrollTop: 0,
  3.   duration: 300
  4. })