格式:let obj = new BScroll(object,{[option1,],.,.});
注意,如果在某一個組件內創建了一個BScroll的實例,在組件生命周期結束前要注意調用destroy方法,否則在滑動過程中切換頁面會導致一直觸發scroll事件,導致一些意想不到的問題,切記!!!
Options 參數
- startX:
0
開始的X軸位置 - startY:
0
開始的Y軸位置 - scrollY:
true
滾動方向為 Y 軸 - scrollX: true 滾動方向為 X 軸
- click:
true
是否派發click事件,通常判斷瀏覽器派發的click還是betterscroll派發的click,可以用_constructed,若是bs派發的則為true - directionLockThreshold:
5
- momentum:
true
當快速滑動時是否開啟滑動慣性 - bounce:
true
是否啟用回彈動畫效果 - selectedIndex:
0
wheel 為 true 時有效,表示被選中的 wheel 索引 - rotate:
25
wheel 為 true 時有效,表示被選中的 wheel 每一層的旋轉角度 - wheel:
false
該屬性是給 picker 組件使用的,普通的列表滾動不需要配置 - snap:
false
該屬性是給 slider 組件使用的,普通的列表滾動不需要配置 - snapLoop:
false
是否可以無縫循環輪播 - snapThreshold:
0.1
用手指滑動時頁面可切換的閾值,大於這個閾值可以滑動的下一頁 - snapSpeed:
400
, 輪播圖切換的動畫時間 - swipeTime:
2500
swipe 持續時間 - bounceTime:
700
彈力動畫持續的毫秒數 - adjustTime:
400
wheel 為 true 有用,調整停留位置的時間 - swipeBounceTime:
1200
swipe 回彈 時間 - deceleration:
0.001
滾動動量減速越大越快,建議不大於0.01 - momentumLimitTime:
300
符合慣性拖動的最大時間 - momentumLimitDistance:
15
符合慣性拖動的最小拖動距離 - resizePolling:
60
重新調整窗口大小時,重新計算better-scroll的時間間隔 - preventDefault:
true
是否阻止默認事件 - preventDefaultException:
{ tagName: /^(INPUT|TEXTAREA|BUTTON|SELECT)$/ }
阻止默認事件 - HWCompositing:
true
是否啟用硬件加速 - useTransition:
true
是否使用CSS3的Transition屬性 - useTransform:
true
是否使用CSS3的Transform屬性 - probeType:
1
滾動的時候會派發scroll事件,會截流。2
滾動的時候實時派發scroll事件,不會截流。3
除了實時派發scroll事件,在swipe的情況下仍然能實時派發scroll事件
Events 事件
- beforeScrollStart - 滾動開始之前觸發
- scrollStart - 滾動開始時觸發
- scroll - 滾動時觸發
- scrollCancel - 取消滾動時觸發
- scrollEnd - 滾動結束時觸發
- touchend - 手指移開屏幕時觸發
- flick - 觸發了 fastclick 時的回調函數
- refresh - 當 better-scroll 刷新時觸發
- destroy - 銷毀 better-scroll 實例時觸發
Example:
let scroll =
probeType: 3
scroll
函數列表
- scrollTo(x, y, time, easing)
滾動到某個位置,x,y 代表坐標,time 表示動畫時間,easing 表示緩動函數
scroll.scrollTo(0, 500)
- scrollToElement(el, time, offsetX, offsetY, easing)
滾動到某個元素,el(必填)表示 dom 元素,time 表示動畫時間,offsetX 和 offsetY 表示坐標偏移量,easing 表示緩動函數
- refresh()
強制 scroll 重新計算,當 better-scroll 中的元素發生變化的時候調用此方法
- getCurrentPage()
snap 為 true 時,獲取滾動的當前頁,返回的對象結構為 {x, y, pageX, pageY},其中 x,y 代表滾動橫向和縱向的位置;pageX,pageY 表示橫向和縱向的頁面索引。用法如:getCurrentPage().pageX
- goToPage(x, y, time, easing)
snap 為 true,滾動到對應的頁面,x 表示橫向頁面索引,y 表示縱向頁面索引, time 表示動畫,easing 表示緩動函數(可省略不寫)
- enable()啟用 better-scroll,默認開啟
- disable() 禁用 better-scroll
- destroy() 銷毀 better-scroll,解綁事件
本人最近在做項目時發現,v0.1.15以上版本的better-scroll無法設置snap循環屬性,查閱部分資料和論壇后發現,是版本的問題,詳情見代碼
1 this.slider = new BScroll(this.$refs.slider, { 2 scrollX: true, 3 scrollY: false, 4 momentum: false, // 慣性 5 snap: { 6 loop: this.loop, // 循環 7 threshold: 0.3, 8 speed: 400 // 輪播間隔 9 }, 10 click: true 11 })