Skip to content

滾動

pageScrollTo

TIP

該API使用方法為: wx.pageScrollTo(Object object)

  • 功能說明: 將頁面滾動到目標位置。
  • 參數及說明: Object object
内容類型預設值必填說明
scrollTopnumber-滾動到頁面的目標位置,單位px
durationnumber300滾動動畫的時長,單位ms
successFunction-接口調用成功的回呼函數
failFunction-接口調用失敗的回呼函數
completeFunction-接口調用結束的回呼函數(無論成功與否都執行)
  • 示例代碼:
js
wx.pageScrollTo({
  scrollTop: 0,
  duration: 300
})

ScrollViewContext

  • 功能說明: 增强ScrollView實例,可通過 wx.createSelectorQueryNodesRef.node 方法獲取。 僅在scroll-view組件開啟enhanced内容後生效。
  • 内容及說明
内容類型說明
scrollEnabledboolean滾動開關
bouncesboolean設定滾動邊界彈性(僅在iOS下生效)
showScrollbarboolean設定是否顯示滾動條
pagingEnabledboolean分頁滑動開關
fastDecelerationboolean設定滾動减速速率(僅在iOS下生效)
decelerationDisabledboolean取消滾動慣性(僅在iOS下生效)
  • 示例代碼:
js
wx.createSelectorQuery()
  .select('#scrollview')
  .node()
  .exec((res) => {
    const scrollView = res[0].node;
    scrollView.scrollEnabled = false;
  })

.scrollIntoView

TIP

該API使用方法為: ScrollViewContext.scrollIntoView(string selector, object ScrollIntoViewOptions)

  • 功能說明: 滾動至指定位置。
  • 參數及說明: string selector, 元素選擇器

.scrollTo

TIP

該API使用方法為: ScrollViewContext.scrollTo(Object object)

  • 功能說明: 滾動至指定位置。
  • 參數及說明: Object object。
内容類型預設值必填說明
topnumber-頂部距離
leftnumber-左邊界距離
velocitynumber-初始速度(僅在iOS下生效)
durationnumber-滾動動畫時長(僅在iOS下生效)
animatednumber-是否啟用滾動動畫