loading...

1

vue使用 better-scroll的参数和方法

vue读完大概需要7分钟

  • 发布时间:2017-12-24 19:41 星期日
  • 刘伟波
  • 792
  • 更新于2018-09-12 19:57 星期三


格式:var obj = new BScroll(object,{[option1,],.,.});

注意:

1、要确保object元素的高度比其父元素高

2、使用时,一定要确保object所在的dom渲染后,再用上面的语句,或者obj.refresh()


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 事件

   代码实例:

let scroll = new BScroll(document.getElementById('wrapper'),{   probeType: 3}) scroll.on('scroll', (pos) => {  console.log(pos.x   '~'   pos.y)})


  • beforeScrollStart - 滚动开始之前触发
  • scrollStart - 滚动开始时触发
  • scroll - 滚动时触发
  • scrollCancel - 取消滚动时触发
  • scrollEnd - 滚动结束时触发
  • touchend - 手指移开屏幕时触发
  • flick - 触发了 fastclick 时的回调函数
  • refresh - 当 better-scroll 刷新时触发
  • destroy - 销毁 better-scroll 实例时触发
  • 函数列表


    • 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,解绑事件


    自己在使用遇到的坑:

    1.scroll.vue组件添加接收的参数,来监听传入的数组变化,来刷新BScroll事件

    data:{
    type:Array,
    default:null
    }
    watch:{
    data(){
    setTimeout(()=>{
    this.refresh()
    },20)
    }
    }

    父组件

    <scroll ref="scroll" class="recommend-content" :data="discList">

    data来监听,里面裹一层div,实现上下滚动



    2. 循环滚动左右会有两个副本来保持无缝滚动

    //        循环滚动左右会有两个副本来保持无缝滚动
    if (this.loop && !isResize) {
    width = 2 * sliderWidth
    }


    3.BScroll点击事件click不能点击问题

    <!--needsclick增加类名就不会和fastclick冲突-->
    <img class="needsclick" :src="item.picUrl" alt="">


    4.懒加载

    import VueLazyload from 'vue-lazyload'
    Vue.use(VueLazyload, {
    loading: require('common/image/default.png')
    })


    <img @load="loadImage()" width="60" height="60" v-lazy="item.imgurl">
    以 轮播渲染出来就重新调用scroll事件
    if(!this.checkLoaded){
    this.$refs.scroll.refresh();
    this.checkLoaded=true;
    }
    }


    5.移动端300ms延迟

    import fastclick from 'fastclick' // 移动端300ms延迟
    fastclick.attach(document.body)




    你可能感兴趣的文章

      发表评论

      评论支持markdown,评论内容不能超过500字符,如果内容过多或者要及时回复,建议去 平台,一般一天之内就会回复。
      关于技术问题或者有啥不懂的都可以留言,我会定期回复答 疑,推荐最新仓库 前端知识体系, 感謝支持!