
better-scroll的使用以及常见的api总结
发布日期:2021-05-08 01:24:10
浏览次数:19
分类:精选文章
本文共 4828 字,大约阅读时间需要 16 分钟。
一、 better-scroll的使用
- 通过
cnpm i -S better-scroll
或者是npm i -S better-scroll
命令就可以进行下载better-scroll
到项目中 - 通过
import BScroll from 'better-scroll';
语句引入到页面当中,再通过new BScroll
创建BScroll对象,接受两个参数,第一个是DOM对象,第二个是options配置项,代码如下示例:
var scroll = new BScroll( this.$refs.movie_body, { tap: true, probeType: 1 });
- 如果想要给BScroll绑定better-scroll的事件,可以通过
scroll.on
去实现,第一个参数是事件名称,第二个是回调函数,传pos参数为位置信息,代码如下示例:
// 绑定滚动事件, pos表示位置信息 scroll.on('scroll', (pos) => { if ( pos.y > 30 ) { this.pullDownMsg = '正在更新中'; } });
- 在使用
better-scroll
的时候,最好在mounted()
钩子函数中,在数据请求完以后,通过this.$nextTick()
,在这个里面写回调函数,去创建BScroll
对象以及后续的操作。因为vue实现响应式,在数据发生变化以后,DOW并不会立即更新,而是按照一定的策略进行更新,Vue中的DOM是异步加载。使用$nextTick()
可以在数据发生变化后立即获得更新后的DOM,也就是说在数据渲染完毕以后,界面渲染完毕以后,再执行方法的回调。代码完整示例如下:
mounted() { this.axios.get('/api/movieOnInfoList?cityId=10').then((res) => { var msg = res.data.msg; if( msg === 'ok') { this.movieList = res.data.data.movieList; this.isLoading = false; // vue实现响应式,在数据发生变化以后,DOW并不会立即更新,而是按照一定的策略进行更新 // 使用 $nextTick() 可以在数据发生变化后立即获得更新后的DOM,也就是说在数据渲染完毕以后,界面渲染完毕以后,再执行方法的回调 this.$nextTick(() => { // 在BScroll对象中,第一个参数为DOM对象, 第二个参数为better-scroll中的配置项 var scroll = new BScroll( this.$refs.movie_body, { tap: true, probeType: 1 }); // 绑定滚动事件, pos表示位置信息 scroll.on('scroll', (pos) => { if ( pos.y > 30 ) { this.pullDownMsg = '正在更新中'; } }); // 绑定点击离开事件,在鼠标或手指离开后触发 scroll.on('touchEnd', (pos) => { if ( pos.y > 30) { this.axios.get('/api/movieOnInfoList?cityId=10').then( (res) => { var msg = res.data.msg; if ( msg === 'ok' ) { this.pullDownMsg = '更新完成'; setTimeout(() => { this.movieList = res.data.data.movieList; this.pullDownMsg = ''; }, 1000); } }); } }); }); } }) },
二、better-scroll的api总结
- Options 参数
startX: 0 开始的X轴位置startY: 0 开始的Y轴位置scrollY: true 滚动方向为 Y 轴scrollX: true 滚动方向为 X 轴click: true 是否派发click事件,通常判断浏览器派发的click还是betterscroll派发的click,可以用_constructed,若是bs派发的则为truedirectionLockThreshold: 5momentum: 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.01momentumLimitTime: 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 = new BScroll(document.getElementById('wrapper'),{ probeType: 3}) scroll.on('scroll', (pos) => { console.log(pos.x + '~' + pos.y)})
- 函数列表
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().pageXgoToPage(x, y, time, easing)snap 为 true,滚动到对应的页面,x 表示横向页面索引,y 表示纵向页面索引, time 表示动画,easing 表示缓动函数(可省略不写)enable()启用 better-scroll,默认开启 disable() 禁用 better-scroll destroy() 销毁 better-scroll,解绑事件
发表评论
最新留言
网站不错 人气很旺了 加油
[***.192.178.218]2025年04月14日 18时30分30秒
关于作者

喝酒易醉,品茶养心,人生如梦,品茶悟道,何以解忧?唯有杜康!
-- 愿君每日到此一游!
推荐文章
oracle 11g not in 与not exists 那个高效?
2019-03-06
Linux 安装Redis 5.0(以及参数调优)
2019-03-06
html5 Game开发系列文章之 零[开篇]
2019-03-06
为什么阿里巴巴建议集合初始化时,指定集合容量大小
2019-03-06
为什么阿里巴巴要求谨慎使用ArrayList中的subList方法
2019-03-06
Redis不是一直号称单线程效率也很高吗,为什么又采用多线程了?
2019-03-06
基于Python的Appium环境搭建合集
2019-03-06
Requests实践详解
2019-03-06
接口测试简介
2019-03-06
Golang Web入门(4):如何设计API
2019-03-06
让sublime实现js控制台(前提是安装了nodejs)
2019-03-06
树莓派连接二手液晶屏小记
2019-03-06
error: 'LOG_TAG' macro redefined
2019-03-06
android10Binder(一)servicemanager启动流程
2019-03-06
ES6基础之——new Set
2019-03-06
nodeJS实现识别验证码(tesseract-ocr+GraphicsMagick)
2019-03-06
玩玩小爬虫——试搭小架构
2019-03-06
AS与.net的交互——加载web上的xml
2019-03-06