首页 > 代码库 > iscroll源码初涉

iscroll源码初涉

2024-07-16 23:01:18   224人阅读

  最近尝试做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};

 


联系
我们