【vue】在移动端使用better-scroll 实现滚动效果
安装依赖:(c)npm install better-scroll --save
引入: import BScroll from 'better-scroll'
格式: var obj = new BScroll(object,{[option1,],.,.});
注意:
1、要确保object元素的高度比其父元素高
2、使用时,一定要确保object所在的dom渲染后再用上面的语句,或者fresh()
Options 参数
- startX:
0
开始的X轴位置- startY:
0
开始的Y轴位置- scrollY:
true
滚动方向为 Y 轴- scrollX: true 滚动方向为 X 轴
- click:
true
是否派发click事件,通常判断浏览器派发的click还是betterscroll派发的click,可以用event._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: 3scroll
函数列表
- 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,解绑事件
参考链接:
作者:smile.轉角
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利.
欢迎关注我,一起进步!扫描下方二维码即可加我QQ

分类:
vue
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 基于Microsoft.Extensions.AI核心库实现RAG应用
· Linux系列:如何用heaptrack跟踪.NET程序的非托管内存泄露
· 开发者必知的日志记录最佳实践
· SQL Server 2025 AI相关能力初探
· Linux系列:如何用 C#调用 C方法造成内存泄露
· 无需6万激活码!GitHub神秘组织3小时极速复刻Manus,手把手教你使用OpenManus搭建本
· Manus爆火,是硬核还是营销?
· 终于写完轮子一部分:tcp代理 了,记录一下
· 别再用vector<bool>了!Google高级工程师:这可能是STL最大的设计失误
· 单元测试从入门到精通