Iscroll解析

摘要：处理函数处理函数都是和检测事件对应的，每一类检测事件都有相应的处理函数。为时，会将等事件绑定到的对象。可通过对进行销毁。注册事件，可注册的函数类型为下一小节函数。

做了一些移动端的产品，发现一些滚动效果很多会使用 iscroll 作为底层库（如阿里小蜜）。iscroll 的文档已经好久没更新了，而且比较简单，经常需要直接读源码。这里写一篇总结，作为对 iscroll API的整理。而 iscroll 的库 probe，lite，zoom，infinite 和标准库等多个版本，而 probe 是平时运用的比较多的一个库，除了 iscroll 的标准库之外，还有 snap（广义翻页） 功能。这里主要以 probe 做整理。去掉里面的 scrollbars/indicators 部分，因为这两部分内容一般视觉不会有太多要求。但这一部分的内容在 iscroll 库中和 iscroll 的主体内容同等地位，个人觉得没有必要。

仔细想想，如果我们要实现类似功能的触控库，我们会怎么做？正常思路大概就是：

检测 ->  处理数据 -> 产生位移

思路大概就是这样，和现实生活中的控制很类似：通过传感器检测数据，而我们这里的检测设备就是注册的一系列事件。检测到的数据往往属于原始数据，没有办法直接使用，这里就需要进行相应的处理。处理完后，就需要滚动屏幕，对应到实现就是操作 dom 的位置属性。

仔细看了一下 iscroll 的源码，果然也是采用类似的思路，一下是 iscroll 核心处理逻辑：

检测

首先，iscroll 检测是每次初始化的时候，通过 HandEvent 注册一系列的函数。为了同时兼容无线和 PC 等多个端，同一类型的事件需要注册多个。简单的分有以下几类：

start 类型事件，如：touchstart，pointerdown，MSPointerDown，mousedown.

move 类型事件，如：touchmove，pointermove，MSPointerMove，mousemove。

end 类型事件，如：touchend，pointerup，touchcancel等。

除了以上三个，还有 transitionend，wheel，keydown，click 等一系列事件。

处理函数
处理函数都是和检测事件对应的，每一类检测事件都有相应的处理函数。如：

_start(e) 函数对应 start 类型事件。

_move(e) 函数对应 move 类型事件。

_end(e) 函数对应 end 类型事件。

除此之外，还有 _transitionEnd(e)，_wheel(e)，_key(e) 等处理函数。

运动函数
处理函数处理好相应数据和逻辑之后，会在处理函数中调用运动相关的函数。而运动相关的函数主要做一些位移变换，iscroll 对这些位移变换做了很多兼容性的处理。

_translate( x, y) 是平移运动的核心函数。其中支持 transform 和 "left" 两种移动方式。

_animate(destX, destY, duration, easingFn) 是带 "transtion" 效果的运动函数，当不支持或关闭 transtion 调用该函数。此函数基于 requestAnimationFrame 做位置移动。

除了这两个内部运动函数之外，iscroll 还提供了 scrollBy，scrollTo，scrollToElement，goToPage，next，prev 等一系列的 API 供外部调用。

var myScroll = new IScroll("#wrapper", {
    mouseWheel: true,
    scrollbars: true
});

初始化出入的第二个参数为配置，会挂载到 myScroll 的 options 属性上。

HWCompositing：是否采用 3D 加速，同时 iscroll 内部还会对客户端是否支持 perspective 属性共同决定。

useTransition：是否采用 css3 的 transition，同时 iscroll 内部还会对客户端是否支持该属性共同决定。

useTransform：是否采用 css3 的 transform，同时 iscroll 内部还会对客户端是否支持该属性共同决定。

tap,click：iscroll 中的两个自定义事件，配置为 string,需要执行的自定义事件。

eventPassthrough：默认为 undefine,为 true 时，关闭默认方向滚动（scrollY）。

bindToWrapper：默认为undefine，控制初始化事件绑定到什么对象上。为 true 时，会将 touch, mousemove 等事件绑定到 iscroll 的 dom 对象。否则，绑定到 window 上。

preventDefault：默认为 true，在各个运动函数中和其他值配合使用。eventPassthrough 为 true 时，设置为 false.

preventDefaultException：默认值 /^(INPUT|TEXTAREA|BUTTON|SELECT)$/，和preventDefault，即内部函数isBadAndroid配合使用，在各个运动函数中执行。

scrollY,scrollX:，初始值为 y 轴方向滚动，即 scrollY 为 true.

freeScroll：默认为 flase，scrollX 和此值同时设置为 true 时，可想任意方向滚动。

directionLockThreshold：默认值为 5，锁定方向的一个阀值，一个方向持续滑动超过这个阀值之后，才会锁定另一方向，一般不需要改动。

resizePolling：默认值 60ms，控制下拉刷新时间。

probeType：默认为 undefine, 可设置为1，2，3。主要用于开启监听 scroll， 值越大灵敏度越高，越耗性能。

momentum：默认为 true，运动的物理引擎，对性能有影响，可关闭。

snap：默认为 undefine，设置为 true 后，可按一定步长移动。

snapSpeed：默认为 300ms，transitionTime 的时间。

snapStepX,snapStepY：默认为 iscroll 的高度或宽度，可设为某一数字，按照相应距离移动。

snapThreshold：默认为0.334，移动到下一步长的阀值系数，此值乘对应页的宽或高。

bounce：默认true，是否开启弹动效果。

bounceEasing：默认为 circular，弹动效果。

bounceTime：默认600ms, 弹动事件

disableMouse,disablePointer,disableTouch：默认为 undefine, 设为 true 时，初始化时会不注册相应事件，达到不响应的效果。

mouseWheel：默认为 undefine，设置为 true 后，开启滑轮。

mouseWheelSpeed：默认为 20ms。

invertWheelDirection：滚动轮方向，无特殊情况不用关注。

keyBindings 默认为键值对，可设置{down: 40}，对应的向下键，向下移动。

destroy()： destory只会销毁所有绑定事件，并不会销毁 iscroll。可通过 iscroll = null 对 iscroll进行销毁。此函数还会触发 destory 事件。

refresh()：调整容器位置，［注意］每次新增或删除 dom 节点后需调用此方法。

on(type, fn)：注册 isroll 事件，可注册的函数类型为下一小节函数。

off(type, fn)：销毁事件。
resetPosition(time)：重置到初始位置。time 为 动效时间。

disable()：静止滑动

enable ()：可滑动。

scrollBy(x, y, time, easing)：增加多少像素滑动。

scrollTo(x, y, time, easing)：滚动到某一像素。

scrollToElement(el, time, offsetX, offsetY, easing)：滚动到某一元素。

getComputedPosition()：获得计算之后的位置，主要键盘中使用。

goToPag(x, y, time, easing)：滚动到某一页，snap 中使用。

next()：滚动到下一页，snap 中使用。

prev()：滚动到上一页，snap 中使用。

beforeScrollStart

scrollStart

scrollCancel

scroll

scrollEnd

destroy

refresh

iscroll 有很多优点，最主要的是相对稳定，还有一系列兼容性处理。但他有一些局限性，主要的局限性是它的可扩展性较差。一个栗子：当我们想对某一元素进行拖拽时，会发现很难用 iscroll。而产生这一问题的主要原因时：iscroll 的 scroll 等监听事件是在元素移动时才会触发。也就说 iscroll 没有暴露出触控 api 给用户使用。