inspired by iscroll, and it has a better scroll perfermance https://ustbhuangyi.github.io/better-scroll/
<body>
<div id="wrapper">
<ul>
<li>...</li>
<li>...</li>
...
</ul>
</div>
<script type="text/javascript" src="better-scroll.js"></script>
<script type="text/javascript">
new BScroll(document.getElementById('wrapper'));
</script>
</body>搞定 !
安装better-scroll
npm install better-scroll引入better-scroll
import BScroll from 'better-scroll'如果不支持import, 请使用
var BScroll = require('better-scroll')better-scroll 的源码是基于 Webpack 构建的
首先，clone项目源码
git clone https://github.com/ustbhuangyi/better-scroll.git安装依赖
cd better-scroll
npm install测试demo页
npm run dev打开浏览器访问如下地址, 查看效果
localhost:9090
Example:
let scroll = new BScroll(document.getElementById('wrapper'), {
startX: 0,
startY: 0
})Options List:
- startX:
0开始的X轴位置 - startY:
0开始的Y轴位置 - scrollY:
true滚动方向为 Y 轴 - scrollX: 'true' 滚动方向为 X 轴
- click:
true是否派发click事件 - directionLockThreshold:
5 - momentum:
true当快速滑动时是否开启滑动惯性 - bounce:
true是否启用回弹动画效果 - selectedIndex:
0wheel 为 true 时有效，表示被选中的 wheel 索引 - rotate:
25wheel 为 true 时有效，表示被选中的 wheel 每一层的旋转角度 - wheel:
false该属性是给 picker 组件使用的，普通的列表滚动不需要配置 - snap:
false该属性是给 slider 组件使用的，普通的列表滚动不需要配置 - snapLoop:
false是否可以无缝循环轮播 - snapThreshold:
0.1用手指滑动时页面可切换的阈值，大于这个阈值可以滑动的下一页 - snapSpeed:
400, 轮播图切换的动画时间 - swipeTime:
2500swipe 持续时间 - bounceTime:
700弹力动画持续的毫秒数 - adjustTime:
400wheel 为 true 有用，调整停留位置的时间 - swipeBounceTime:
1200swipe 回弹 时间 - 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事件
Example:
let scroll = new BScroll(document.getElementById('wrapper'),{
probeType: 3
})
scroll.on('scroll', (pos) => {
console.log(pos.x + '~' + pos.y)
...
})Events 列表
- beforeScrollStart - 滚动开始之前触发
- scrollStart - 滚动开始时触发
- scroll - 滚动时触发
- scrollCancel - 取消滚动时触发
- scrollEnd - 滚动结束时触发
- touchEnd - 手指移开屏幕时触发
- flick - 触发了 fastclick 时的回调函数
- refresh - 当 better-scroll 刷新时触发
- destroy - 销毁 better-scroll 实例时触发
- scrollTo(x, y, time, easing)
滚动到某个位置，x,y 代表坐标，time 表示动画时间，easing 表示缓动函数
Example:
let scroll = new BScroll(document.getElementById('wrapper'))
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 表示横向和纵向的页面索引
- goToPage(x, y, time, easing)
当 snap 为 true，滚动到对应的页面，x 表示横向页面索引，y 表示纵向页面索引， time 表示动画，easing 表示缓动函数
- enable()
启用 better-scroll，默认开启
- disable()
禁用 better-scroll
- destroy()
销毁 better-scroll，解绑事件