移动端网页--better-scroll介绍

移动端网页--better-scroll介绍

Options

起始位置及滚动方向

• startX:0 开始时的X轴位置

• startY:0 开始时的Y轴位置

• scrollY: true 滚动方向为 Y 轴

• scrollX: true 滚动方向为 X 轴

事件参数

• probeType: 1

  • 1滚动的时候会派发scroll事件，会截流。

  • 2滚动的时候实时派发scroll事件，不会截流。

  • 3除了实时派发scroll事件，在swipe的情况下仍然能实时派发scroll事件

• click: true 是否派发click事件，通常判断浏览器派发的click还是betterscroll派发的click，可以用_constructed，若是bs派发的则为true

• preventDefault: true 是否阻止默认事件

• preventDefaultException: { tagName: /^(INPUT|TEXTAREA|BUTTON|SELECT)$/ } 阻止默认事件

picker组件参数

• wheel: false 该属性是给 picker 组件使用的，普通的列表滚动不需要配置

• selectedIndex: 0 wheel 为 true 时有效，表示被选中的 wheel 索引

• rotate: 25 wheel 为 true 时有效，表示被选中的 wheel 每一层的旋转角度

• adjustTime: 400 wheel 为 true 有用，调整停留位置的时间

slider组件snap参数

• snap: false 该属性是给 slider 组件使用的，普通的列表滚动不需要配置

• snapLoop: false 是否可以无缝循环轮播

• snapThreshold: 0.1 用手指滑动时页面可切换的阈值，大于这个阈值可以滑动的下一页

• snapSpeed: 400, 轮播图切换的动画时间

符合惯性拖动设置

• momentumLimitTime: 300 符合惯性拖动的最大时间

• momentumLimitDistance: 15 符合惯性拖动的最小拖动距离

• resizePolling: 60 重新调整窗口大小时，重新计算better-scroll的时间间隔

• HWCompositing: true 是否启用硬件加速

Transition和Transform属性

• useTransition: true 是否使用CSS3的Transition属性

• useTransform: true 是否使用CSS3的Transform属性

其他参数设置

• swipeTime: 2500 swipe 持续时间

• bounceTime: 700 弹力动画持续的毫秒数

• deceleration: 0.001 滚动动量减速越大越快，建议不大于0.01

• directionLockThreshold: 5

• momentum: true 当快速滑动时是否开启滑动惯性

• bounce: true 是否启用回弹动画效果

Events 事件

• beforeScrollStart - 滚动开始之前触发

• scrollStart - 滚动开始时触发

• scroll - 滚动时触发

• pullingUp-上拉加载

• scrollCancel - 取消滚动时触发

• scrollEnd - 滚动结束时触发

• touchend - 手指移开屏幕时触发

• flick - 触发了 fastclick 时的回调函数

• refresh - 当 better-scroll 刷新时触发

• destroy - 销毁 better-scroll 实例时触发

better-scroll的事件监听： scroll.on('eventName', (e)=>{})

函数列表

• finishPullUp 上拉加载完成

• scrollTo(x, y, time, easing)滚动到某个位置

  • x,y 代表坐标

  • time 表示动画时间

  • easing 表示缓动函数

• 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 表示横向和纵向的页面索引

• oToPage(x, y, time, easing) snap 为 true，滚动到对应的页面

  • x 表示横向页面索引

  • y 表示纵向页面索引

  • time 表示动画

  • easing 表示缓动函数（可省略不写）

• enable() 启用 better-scroll，默认开启

• disable() 禁用 better-scroll

• destroy() 销毁 better-scroll，解绑事件