天天看点

vue插件better-scroll

页面如果想实现滚动效果,首先想到的是overflow:auto或者scroll属性,但是这样会出现滚动条,如果想实现滚动效果,有没有滚动条的话,那么推荐使用better-scroll插件。

一、安装

在package.json里面加入better-scroll的依赖,然后使用npm安装。

npm install better-scroll –save-dev

二、引入better-scroll

import BScroll from ‘better-scroll’

三、使用better-scroll

//普通页面

let scroll = new BScroll(document.getElementById('wrapper'), {
  startX: ,
  startY: 
})
           

//vue页面使用

<div class="foods-wrapper" ref="foodswrapper"></div>
this.foodScroll = new BScroll(this.$refs.foodswrapper,{
    probeType: ,
    click: true
});
           

四、参数说明

startX: 0 开始的X轴位置

startY: 0 开始的Y轴位置

scrollY: true 滚动方向

click: true 是否启用click事件

directionLockThreshold: 5

momentum: true 是否开启拖动惯性

bounce: true 是否启用弹力动画效果,关掉可以加速

selectedIndex: 0

rotate: 25

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

snap: false 是否开启捕捉元素,当为 true 时,捕捉的元素会根据可滚动的位置和滚动区域计算得到可滑动几页。

snapLoop: false 是否创建当前滚动元素子集的拷贝

snapThreshold: 0.1 滑动的长度限制,只有大于这个距离才会触发事件

swipeTime: 2500 swipe 持续时间

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

adjustTime: 400

swipeBounceTime: 1200

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

momentumLimitTime: 300 惯性拖动的回弹时间

momentumLimitDistance: 15 惯性拖动的回弹距离

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

probeType: 1 监听事件的触发时间,1为即时触发,3为延迟到事件完毕后触发

preventDefault: true 是否阻止默认事件

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

HWCompositing: true 是否启用硬件加速

useTransition: true 是否使用CSS3的Transition属性,否则使用-requestAnimationFram代替

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

probeType: 1 滚动的时候会派发scroll事件,会截流。2滚动的时候实时派发scroll事件,不会截流。 3除了实时派发scroll事件,在swipe的情况下仍然能实时派发scroll事件

五、Events 事件

let scroll = new BScroll(document.getElementById('wrapper'),{
   probeType: 
})

scroll.on('scroll', (pos) => {
  console.log(pos.x + '~' + posx.y)
  ...
})
           

六、Events 列表

beforeScrollStart - 滚动开始之前触发

scrollStart - 滚动开始时触发

scroll - 滚动时触发

scrollCancel - 取消滚动时触发

scrollEnd - 滚动结束时触发

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

refresh - 当 better-scroll 刷新时触发

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

七、派发滚动

let scroll = new BScroll(document.getElementById('wrapper'))
scroll.scrollTo(, )
           

参数说明:

scrollTo(x, y, time, easing) 滚动到某个位置,x,y 代表坐标,time 表示动画时间,easing 表示缓动函数

scrollToElement(el, time, offsetX, offsetY, easing) 滚动到 某个元素,el(必填)表示 dom 元素,time 表示动画,offsetX 和 offsetY 表示坐标偏移量,easing 表示缓动函数

八、多余的触发

在PC页面时,点击不会被 better-scroll阻止事件,初始化,给 better-scroll派发事件,使移动端拥有点击事件,因此切换到PC端时,点击事件会被执行两次

==解决办法==:在点击时,传 $event变量,Better-scroll插件中的 event事件和原生 js的 event有属性上得区别,Better-scroll插件派发的事件时event_constructed为true,原生点击事件是没有这个属性的,在这里判断,如果没有这个属性就直接跳出函数。

selectMenu(index,event){
    if(!event._constructed){//如果不存在这个属性,则不执行下面的函数
        return;
    }
}
           

文章转载来源:简书

原作者:执念_7e57

链接:https://www.jianshu.com/p/0e60d816f7bf

继续阅读