iscroll源码初涉

  最近尝试做web app时候，用上了神器iScroll，鉴于功力尚浅，并没有完全用好神器，所以今天特意来认真学习！

  翻开官网，目前的版本是5，但是相关的文章并不多，具体的文件版本是：

• iscroll.js 常规版本
• iscroll-lite.js 阉割版本，如果只需要滑动功能，推荐这个，体积很小。不支持snap,scrollbars,mouse wheel,key bindings。
• iscroll-probe.js 专门提供获取当前位置的功能，未来可能在常规版本中加入。
• iscroll-zoom.js 添加zooming功能
• iscroll-infinlte.js 由于过长的列表滚动对手机设备硬件要求较高，所以此版本利用缓存机制来达到这效果。

  项目里面用的是iscroll-probe这个版本，具体原因是需要使用定位功能，但是今天学习，还是选软柿子（iscroll-lite）来捏吧。

  进门第一段代码：

//请求动画帧

var rAF = window.requestAnimationFrame   ||

    window.webkitRequestAnimationFrame   ||

    window.mozRequestAnimationFrame      ||

    window.oRequestAnimationFrame        ||

    window.msRequestAnimationFrame       ||

    function (callback) { window.setTimeout(callback, 1000 / 60); };

/*

显示器16.7ms刷新间隔之前发生了其他绘制请求(setTimeout)，导致所有帧丢失，setTimeout的定时器值推荐最小使用16.7ms的原因（16.7 = 1000 / 60, 即每秒60帧）

requestAnimationFrame与setTimeout的不同在于，前者跟着浏览器重绘时间走，不存在后者丢帧的问题

*/

 

　　

   完全不懂……于是马上找鑫爷的博客翻看才知这是一个js的动画接口----请求动画帧，requestAnimationFrame与setTimeout的不同在于，前者跟着浏览器重绘时间走，不存在后者丢帧的问题。《CSS3动画那么强，requestAnimationFrame还有毛线用？》。 

　　大概初窥到iScroll的滑动效果的大门，继续往下看，结构非常清晰：util + iscroll + iscroll.prototype。

　　util主要是封装了一些获取样式名称（前缀）的方法，事件绑定方法，动画缓动方法，样式操作方法，其中最重要的是 preventDefaultException , tap , click这三个方法。

// 配合config里面的preventDefaultException属性，匹配到的element使用e.preventDefault()。

// 默认preventDefaultException是 { tagName: /^(INPUT|TEXTAREA|BUTTON|SELECT)$/ }

me.preventDefaultException = function (el, exceptions) {

    for ( var i in exceptions ) {

        if ( exceptions[i].test(el[i]) ) {

            return true;

        }

    }

    return false;

};



me.tap = function (e, eventName) {

    var ev = document.createEvent('Event');

    /**

    只有在新创建的 Event 对象被 Document 对象或 Element 对象的 dispatchEvent() 方法分派之前，才能调用 Event.initEvent() 方法        

    初始化新事件对象的属性

    */

    ev.initEvent(eventName, true, true);

    ev.pageX = e.pageX;

    ev.pageY = e.pageY;

    //事件触发器就是用来触发某个元素下的某个事件

    e.target.dispatchEvent(ev);

};



me.click = function (e) {

    var target = e.target,

        ev;
    //不是select/input/textarea就创建事件 if ( !(/(SELECT|INPUT|TEXTAREA)/i).test(target.tagName) ) {

        ev = document.createEvent('MouseEvents');

        ev.initMouseEvent('click', true, true, e.view, 1,

            target.screenX, target.screenY, target.clientX, target.clientY,e.ctrlKey, e.altKey, e.shiftKey, e.metaKey,0, null);

　　　//作为是否需要perventDefault的标志　　

        ev._constructed = true;

        target.dispatchEvent(ev);

    }

};

 　　继续往下，就是iScroll的初始化操作，new iScroll的时候，会优先处理一些默认设置，其中有如下几点需要注意：

1. eventPassthrough参数支持两种写法，一是boolean类型true / false ， 二是string类型'vertical' / 'horizontal'；
2. eventPassthrough设为true时候，会自动转为'vertical'，并且会设置scrollX为false，即水平滑动的时候，使用的是浏览器原生滑动；
3. freeScroll只能与scrollX一起使用 {scrollX:true,freeScroll:true}

　　最后就是

// IScroll初始化鼠标/手势事件

this._init();

// 设置可滑动值

this.refresh();

// 定位到最顶最左

this.scrollTo(this.options.startX, this.options.startY);

// 代表“启用”的一个标志

this.enable();

　　此中最重要的是_init方法里面调用的_initEvents, 使用的是handleEvent。 利用这个特性可以把任意对象注册为事件处理程序，只要它拥有 handleEvent 方法。

所以iScroll里面有一个handleEvent属性，利用element.addEventListener( 'transitionend', IScroll)的方式，来处理相关事件。

IScroll.prototype = {

　　handleEvent: function (e) {

   　　 switch ( e.type ) {

            case 'touchstart':

                ......

                this._start(e);

                break;

            case 'touchmove':

                ......

                this._move(e);

                break;

            case 'touchend':

                ......

                this._end(e);

                break;

            case 'orientationchange':

            case 'resize':

                this._resize();

                break;

            case 'transitionend':

                ......

                this._transitionEnd(e);

                break;

            case 'wheel':

                ......

                this._wheel(e);

                break;

            case 'keydown':

                this._key(e);

                break;

            case 'click':

                if ( !e._constructed ) {

                    e.preventDefault();

                    e.stopPropagation();

                }

                break;

        }

    }

}    

 

     好了，iScroll的初始化以及事件处理已经差不多了，接下来就是事件处理程序，估计也是一些位置处理的东西了吧，继续：

• _start(e)    具体作用是初始化一些位置信息;
• _move(e)  移动过程更新位置信息，触发动态效果;
• _end(e)     结束时根据是否需要缓动而作相应的缓动动作

　　具体的可以查看我写的《iscroll-lite源码注释》，其实，看完源码，真的没什么很复杂的，但是有几点觉得有待商榷的：

1. 对于_execEvent(eventType)的方法，应该再加上当前触发的event对象，_execEvent( eventType,event )，因为在执行的时候this._events[type][i].apply(this, [].slice.call(arguments, 1));会从第二个参数截取，加上event对象，有助于我们判断是在哪个元素上触发事件。
2. off解绑事件，缺乏一次性解绑的方法，建议把解绑的方法修改如下：

   if ( index > -1 ) {
   
       this._events[type].splice(index, 1);
   
   }else{
   
       this._events[type].length = 0;
   
   }

    

　　最后送上完整的参数设置：

var options = {

    startX: 0,

    startY: 0,    

    //Y轴是否滑动

    scrollY: true,

    //X轴是否滑动

    scrollX: true,

    //是否自由滑动 x y都滑 ， freeScroll只能与scrollX一起使用 {scrollX:true,freeScroll:true}

    freeScroll : false,

    //方向锁定阈值，比如用户点击屏幕后，x与y之间差距大于5px，判断用户的拖动意图，是x方向拖动还是y方向

    directionLockThreshold: 5,

    //是否有惯性缓冲动画

    momentum: true,

    //超出边界时候是否还能拖动

    bounce: true,

    //超出边界还原时间点

    bounceTime: 600,

    //超出边界返回的动画

    bounceEasing: '',

    //是否阻止默认滚动事件

    preventDefault: true,

    //当遇到表单元素则不阻止冒泡，而是弹出系统自带相应的输入控件

    preventDefaultException: { tagName: /^(INPUT|TEXTAREA|BUTTON|SELECT)$/ },

    //硬件合成 通过GPU做图形渲染

    HWCompositing: true,

    //使用transition

    useTransition: true,

    //使用transform

    useTransform: true,

    //穿透 是否不触发原生滑动

    eventPassthrough : false,

    //缓动函数 {string|function}

    bounceEasing : '',

    //resize时候隔60ms就执行refresh方法重新获取位置信息

    resizePolling : 60,

    //是否允许点击事件

    click : false,

    //模拟tap事件，并且触发addEventListener('tap')所指定的方法

    tap : 'tap',

    //匀减速变量

    deceleration : 0.0006,

    //事件是否绑定到wrapper元素上，否则大部分绑定到window

    bindToWrapper : false.

    //是否禁用鼠标

    disableMouse : false,

    //是否禁用win系统的pointer事件

    disablePointer : false,

    //是否禁用touch事件

    disableTouch : false

};