better-scroll滚动插件的使用

better-scroll 是什么？

better-scroll 是一款重点解决移动端（已支持 PC）各类滚动场景需求的插件。它的核心是借鉴的 iscroll 的实现，它的 API 设计基本兼容 iscroll，在 iscroll 的基础上又扩展了一些 feature 以及作了一些性能优化。

better-scroll 是基于原生 JS 实现的，不依赖任何框架。它编译后的代码大小是 63kb，压缩后是 35kb，gzip 后仅有 9kb，是一款很是轻量的 JS lib。

滚动原理

先来看一下浏览器的滚动原理：浏览器的滚动条你们都会遇到，当页面内容的高度超过视口高度的时候，会出现纵向滚动条；当页面内容的宽度超过视口宽度的时候，会出现横向滚动条。也就是当咱们的视口展现不下内容的时候，会经过滚动条的方式让用户滚动屏幕看到剩余的内容。

better-scroll 也是同样的原理，以下图，能够更直观的来感觉一下：

绿色部分为 wrapper，也就是父容器，它会有固定的高度。黄色部分为 content，它是父容器的第一个子元素，它的高度会随着内容的大小而撑高。那么，当 content 的高度不超过父容器的高度，是不能滚动的，而它一旦超过了父容器的高度，咱们就能够滚动内容区了，这就是 better-scroll 的滚动原理。

注：在使用的时候外部容器的须要设置固定高度，还有一个问题须要设置overflow:hidden,这是由于为了隐藏超出部分。
有一点须要特别注意：滚动的元素只能是第一个容器的第一个元素

better-scroll 的使用

例如：

经过npm引入

安装better-scroll

npm install better-scroll

引入better-scroll

import BScroll from 'better-scroll'

若是不支持import，请使用require来引入

开始使用插件

DOM结构

<div class="wrapper">
    <ul class="content">
      <li>...</li>
      <li>...</li>
      ...
    </ul>
</div>
复制代码

wrapper里只能有一层元素，也就是须要滚动的元素，使用了better-scroll以后，会自动在content加上动画的样式。

<!-- 这种结构是不能够滚动的 -->
<div class="wrapper">
    <ul class="content">
      ...
    </ul>
    <ul class="content">
      ...
    </ul>
</div>
<!-- 若是须要滚动的话加一层div包裹着两个ul标签 -->
复制代码

wrapper必定须要指定高度，否则是没法滚动的。 须要看系统使用的定位是absolute仍是flex，若是是flex是有默认的高度的，就不须要本身手动设置wrapper的高度。

注：父级bscroll必须有高度，而且overflow为hidden;

插件使用

mounted(){
    this.$nextTick(() => {
        let bscrollDom = this.$refs.bscroll;
        this.bscroll = new BScroll(bscrollDom,{ Option参数 }) //重点代码
    })   
}
复制代码

注：
1.插件初始化时须要具体元素，因此在DOM结构中使用ref标记元素(而后使用上面的代码$refs获取元素)，以备插件使用;
2.建议放在nextTick方法里面，避免DOM结构未渲染完成,从而形成子元素bscroll-container高度计算不许确;
3.建议使用this.bscroll方式定义，以备在其余方法中使用;
4.使用时必定要 new，使用时必定要 new，使用时必定要 new
重要的事情说三遍

Option 参数

• startX: 0 开始的X轴位置
• startY: 0 开始的Y轴位置
• scrollX: 'true' 滚动方向为 X 轴
• scrollY: true 滚动方向为 Y 轴
• click: true 是否派发click事件
• 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在手指 move 的时候也会实时派发 scroll 事件，不会截流。 3除了手指 move 的时候派发scroll事件，在 swipe（手指迅速滑动一小段距离）的状况下，列表会有一个长距离的滚动动画，这个滚动的动画过程当中也会实时派发滚动事件

Events 事件

例如：

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

scroll.on('scroll', (pos) => {
  console.log(pos.x + '~' + pos.y)
  ...
})
复制代码

Events 列表

• beforeScrollStart - 滚动开始以前触发
• scrollStart - 滚动开始时触发
• scroll - 滚动时触发
• scrollCancel - 取消滚动时触发
• scrollEnd - 滚动结束时触发
• touchend - 手指移开屏幕时触发
• flick - 轻拂时触发
• refresh - 当 better-scroll 刷新时触发
• destroy - 销毁 better-scroll 实例时触发

方法

• scrollTo(x, y, time, easing)

滚动到某个位置，x,y 表明坐标，time 表示动画时间，easing 表示缓动函数

例如：

let scroll = new BScroll(document.getElementById('wrapper'))
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 表示横向和纵向的页面索引

• goToPage(x, y, time, easing)

当 snap 为 true，滚动到对应的页面，x 表示横向页面索引，y 表示纵向页面索引， time 表示动画，easing 表示缓动函数

• enable()

启用 better-scroll，默认开启

• disable()

禁用 better-scroll

• destroy()

销毁 better-scroll，解绑事件

那些年走过的坑

DOM相关

当 DOM 结构发生变化的时候务必要调用refresh()确保滚动的效果正常，从新渲染高度

还有就是我上面写的DOM层级关系，wrapper里面必定不能存在多个同级的标签

content是否被成功添加滚动相关style

如下面dom结构为例：

<div class="classifyTitle"  ref="wrapper">
	<ul>
	    <li v-for="(item,index) in classifyData.products">
		<router-link :to="{name:'详情'}">{{item.title}}</router-link>
	    </li>
	</ul>				
</div>
复制代码

审查元素能够看到：

这样即添加成功的

wrapper 与 content 高度问题

只有content的高度大于wrapper高度时候，才能够滚动。

如何看？

this.$nextTick(() => {
    if (!this.scroll) {
	this.scroll = new BScroll(this.$refs.wrapper, {})
	console.log(this.scroll)
    }
 })
复制代码

F12就能够看到打印结果：

以上就是能够滚动的状况，wrapperHeight(616) < scrollHeight(750)，hasVerticalScroll为true；

若是这些数据不对，检查是否dom没有更新完就初始化BScroll了，要等dom更新完才能初始化

wrapper 样式

.wrapper元素上要给定位

position: absolute;
left: 0;
top: 0;
overflow: hidden;
复制代码

---

^_<