better-scroll的使用以及常见的api总结

一、 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派发的则为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 = 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-scrolldestroy() 销毁 better-scroll，解绑事件

better-scroll的使用以及常见的api总结相关推荐

【小程序】常见系统API | 页面分享 | 位置信息 | 本地存储
文章目录常见系统API 页面分享的基本介绍设备信息和位置信息小程序Storage存储常见系统API 页面分享的基本介绍分享是小程序扩散的一种重要方式,小程序中有两种分享方式: 方式一:点击右 ...
C语言中常见字符串API详解
以下均为笔记,草率见谅,首先介绍下在字符串章节所用的函数,再介绍几个常见的api malloc 函数原型:void *malloc(size_t size) C库函数void *malloc(size ...
API是什么？有哪些常见的API？
转自 https://blog.csdn.net/cumtdeyurenjie/article/details/80211896#t2 和https://blog.csdn.net/weixin_38 ...
常见开放api平台-OpenAPI
所谓的开放API(OpenAPI)是服务型网站常见的一种应用,网站的服务商将自己的网站服务封装成一系列API(Application Programming Interface,应用编程接口)开放出去 ...
✨字符串de介绍及其常见的api
字符串计算机产生之初,内部只能识别二进制数字,无法识别英文字母和符号.为了能让计算机识别字母.数字和符号,科学家们制定了一个对照表,字母.数字.符号跟二进制数字相对应,这样当人们输入字母的时候,计 ...
常见的API接口漏洞总结
常见API接口漏洞了解接口常见漏洞,将帮助你在测试接口获取更多的思路. 信息披露信息可能会在 API 响应或公共来源(如代码存储库.搜索结果.新闻.社交媒体.目标网站和公共 API 目录)中披露. ...
Openresty最佳案例 | 第4篇：OpenResty常见的api
获取请求参数 vim /usr/example/example.conf location /lua_var {default_type 'text/plain';content_by_lua_bl ...
在NodeJS中操作文件常见的API
阅读目录一:如何读整个文件内容? 二:如何写入整个文件内容? 三:如何在文件中的指定位置处读入内容? 四:如何在文件中的指定位置处写入内容? 五:如何创建与读取目录? 六:如何查看与修改文件或目录的 ...
【unity基础_Day02】 Tranform组件及常见的API
一.常用API 1.Transform (1)Vector3 (2)translate(参数1:世界坐标,参数2:局部坐标) (3)FixUpdate:以固定帧数更新,主要作用于物理或者刚体等组件 ( ...
Swagger常见注解@API、@ApiOperation、@ApiParam等
Swagger2一些常用注解最近遇到了一个使用swagger来生成接口文档的项目,在controller看到了一些没用过的注解(@API.@ApiOperation等),遂记录一下 @API 使用在 ...

better-scroll的使用以及常见的api总结

一、 better-scroll的使用

二、better-scroll的api总结

better-scroll的使用以及常见的api总结相关推荐

最新文章

热门文章