微信小程序視圖容器 scroll-view

2022-05-11 16:04 更新

scroll-view


可滾動視圖區(qū)域。

屬性名 類型 默認值 說明
scroll-x Boolean false 允許橫向滾動
scroll-y Boolean false 允許縱向滾動
upper-threshold Number 50 距頂部/左邊多遠時(單位px),觸發(fā) scrolltoupper 事件
lower-threshold Number 50 距底部/右邊多遠時(單位px),觸發(fā) scrolltolower 事件
scroll-top Number   設置豎向滾動條位置
scroll-left Number   設置橫向滾動條位置
scroll-into-view String   值應為某子元素id(id不能以數(shù)字開頭)。設置哪個方向可滾動,則在哪個方向滾動到該元素
scroll-with-animation Boolean false 在設置滾動條位置時使用動畫過渡
enable-back-to-top Boolean false iOS點擊頂部狀態(tài)欄、安卓雙擊標題欄時,滾動條返回頂部,只支持豎向
bindscrolltoupper EventHandle   滾動到頂部/左邊,會觸發(fā) scrolltoupper 事件
bindscrolltolower EventHandle   滾動到底部/右邊,會觸發(fā) scrolltolower 事件
bindscroll EventHandle   滾動時觸發(fā),event.detail = {scrollLeft, scrollTop, scrollHeight, scrollWidth, deltaX, deltaY}

使用豎向滾動時,需要給<scroll-view/>一個固定高度,通過 WXSS 設置 height。

示例代碼:

<view class="section">
  <view class="section__title">vertical scroll</view>
  <scroll-view scroll-y style="height: 200px;" bindscrolltoupper="upper" bindscrolltolower="lower" bindscroll="scroll" scroll-into-view="{{toView}}" scroll-top="{{scrollTop}}">
    <view id="green" class="scroll-view-item bc_green"></view>
    <view id="red"  class="scroll-view-item bc_red"></view>
    <view id="yellow" class="scroll-view-item bc_yellow"></view>
    <view id="blue" class="scroll-view-item bc_blue"></view>
  </scroll-view>

  <view class="btn-area">
    <button size="mini" bindtap="tap">click me to scroll into view </button>
    <button size="mini" bindtap="tapMove">click me to scroll</button>
  </view>
</view>
<view class="section section_gap">
  <view class="section__title">horizontal scroll</view>
  <scroll-view class="scroll-view_H" scroll-x="true" style="width: 100%">
    <view id="green" class="scroll-view-item_H bc_green"></view>
    <view id="red"  class="scroll-view-item_H bc_red"></view>
    <view id="yellow" class="scroll-view-item_H bc_yellow"></view>
    <view id="blue" class="scroll-view-item_H bc_blue"></view>
  </scroll-view>
</view>


var order = ['red', 'yellow', 'blue', 'green', 'red']
Page({
  data: {
    toView: 'red',
    scrollTop: 100
  },
  upper: function(e) {
    console.log(e)
  },
  lower: function(e) {
    console.log(e)
  },
  scroll: function(e) {
    console.log(e)
  },
  tap: function(e) {
    for (var i = 0; i < order.length; ++i) {
      if (order[i] === this.data.toView) {
        this.setData({
          toView: order[i + 1]
        })
        break
      }
    }
  },
  tapMove: function(e) {
    this.setData({
      scrollTop: this.data.scrollTop + 10
    })
  }
})

scroll-view

Bug & Tip

  1. tip: 請勿在scroll-view中使用textareamap、canvas、video組件
  2. tip: scroll-into-view的優(yōu)先級高于scroll-top
  3. tip: 在滾動scroll-view時會阻止頁面回彈,所以在scroll-view中滾動,是無法觸發(fā)onPullDownRefresh
  4. tip: 若要使用下拉刷新,請使用頁面的滾動,而不是scroll-view,這樣也能通過點擊頂部狀態(tài)欄回到頁面頂部


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號