jQuery源码分析(二十三): 动画

前端基础 2016-12-27

起步

jq有自己的动画引擎,约有800行的代码,虽然没有样式操作的1200行多,但是也不可缺少。

队列操作

jQuery 中有一个 Queue 队列的接口,这个队列有多个用途, animate 添加的动画就是使用默认的 ’fx’ 队列完成的。

队列是个线性队列,遵循的是 先进先出 的原则。一个动画执行完才会执行下一个动画,另外,动画的执行需含有异步过程的。queue的价值就是允许一系列函数被异步地调用而不会阻塞程序

jQuery 提供了 2 组队列操作的 API:

jQuery.queue/dequeue
jQuery.fn.queue/dequeue

fn的队列在静态方法基础上的高级API供给实例使用的。 dequeue 不仅执行出队操作(取出头元素),还会自动执行头元素。

一个简单的队列实现如下:

function queue(ele, fn) {
    if (!ele.cache) {
        ele.cache = [];
    }

    ele.cache.push(fn);
}

function dequeue(ele) {
    var next = function() {
        dequeue(ele);
    };
    var fn = ele.cache.shift();
    fn.call(ele, next);
}

如何实现异步调用呢?在栈出的函数fn中传入next参数即可实现,只要函数内调用 next() ,即可实现异步调用下一个。

jquery的实现更精密,还考虑了队列栈出为空后调用钩子函数销毁,type参数省略自动调整。

jQuery.queue/dequeue

$.queue : 显示或操作匹配的元素上已经执行的函数列队。

queue: function( elem, type, data ) {
    var queue;

    if ( elem ) {
        type = ( type || "fx" ) + "queue";
        //获取队列数据
        queue = data_priv.get( elem, type );
        if ( data ) {
            // data为数组,则直接替换掉原缓存值。原本无值,则指定为空数组
            if ( !queue || jQuery.isArray( data ) ) {
                queue = data_priv.access( elem, type, jQuery.makeArray(data) );
            } else {
                // 将函数推入队列
                queue.push( data );
            }
        }
        return queue || [];
    }
},

可见,$.queue既是setter,也是getter;data为设置,无data为读取,都返回该队列。 它有三个参数: elem 是dom元素, type是字符串, data是function或数组。

默认的 type = (type || "fx") + "queue" 是专职供fx动画队列处理的。

$.dequeue : 匹配的元素上执行队列中的下一个函数

dequeue: function( elem, type ) {
    type = type || "fx";
    //取出队列
    var queue = jQuery.queue( elem, type ),
        startLength = queue.length,
        fn = queue.shift(),//取出第一个队列
        hooks = jQuery._queueHooks( elem, type ),
        next = function() {
            jQuery.dequeue( elem, type );
        };

    // If the fx queue is dequeued, always remove the progress sentinel
    // 只适用于'fx'队列。凡被dequeue过,开头都是"inprogress",需要再shift()一次
    if ( fn === "inprogress" ) {
        fn = queue.shift();
        startLength--;
    }

    if ( fn ) {

        // Add a progress sentinel to prevent the fx queue from being
        // automatically dequeued
        // 如果开始执行,就需要加一个进程锁
        // 如果是dequeue操作, 去掉锁, 执行队列里的函数, 同时给队列加上锁. 
        // 如果是queue操作, 要看锁的状态, 如果被锁上了, 就只执行队列的添加操作. 不再调用dequeue.
        // 'fx'队列,开头加"inprogress"。用于表明队列在运行中,不能立即执行添加的函数
        if ( type === "fx" ) {
            queue.unshift( "inprogress" );
        }

        // Clear up the last queue stop function
        delete hooks.stop;
        fn.call( elem, next, hooks );// 参数注入,可用来在fn内部递归dequeue
    }

    // fn不存在,调用钩子销毁队列和钩子本身
    if ( !startLength && hooks ) {
        hooks.empty.fire();
    }
},

通过 queue 的 get 取出队列的所有数据,判断一下长度,然后截取出第一个,然后做好一个预处理生成下一个的 next

这里有个钩子queueHooks:

// Not public - generate a queueHooks object, or return the current one
// 自毁钩子,队列无函数时dequeue会触发。存在元素私有缓存上
_queueHooks: function( elem, type ) {
    var key = type + "queueHooks";
    return data_priv.get( elem, key ) || data_priv.access( elem, key, {
        empty: jQuery.Callbacks("once memory").add(function() {
            // 销毁队列缓存
            data_priv.remove( elem, [ type + "queue", key ] );
        })
    });
}

钩子其实就是 jQuery.Callbacks 对象,可以实现一个收集器的功能。

startLength 为0时,开始清理工作:

if ( !startLength && hooks ) {
    hooks.empty.fire();
}

实例方法的队列

.queue() 是对 $.queue() 的扩充,其内部是调用的 $.queue$.dequeue 静态的底层方法实现入列与出列。

jQuery.fn.extend({
    queue
    dequeue
    delay
    clearQueue
    promise
});
queue: function( type, data ) {
    var setter = 2;
    // 修正type  默认值为'fx'
    if ( typeof type !== "string" ) {
        data = type;
        type = "fx";
        setter--;
    }
    // 无data表示取值,只取this[ 0 ]对应值
    if ( arguments.length < setter ) {
        return jQuery.queue( this[0], type );
    }
    // 写入
    return data === undefined ?
        // 无data,返回调用者
        this :
        this.each(function() {
            //并返回队列总数
            var queue = jQuery.queue( this, type, data );

            // Ensure a hooks for this queue
            // 此方法添加,一定会有hooks
            jQuery._queueHooks( this, type );
            // 'fx'动画队列,首次添加函数直接触发
            if ( type === "fx" && queue[0] !== "inprogress" ) {
                // 队列第一个元素是"inprogress",说明没有被锁住
                // 即此时没有在执行dequeue. 移出队列里第一个函数并执行它
                jQuery.dequeue( this, type );
            }
        });
},

实例的queue接口只是做了2个情况的判断,一种是传递fx,一种是设置队列,底层还是通过jQuery.queue静态方法处理的

dequeue: function( type ) {
    // 遍历触发,以支持$(elems).dequeue(type)
    return this.each(function() {
        jQuery.dequeue( this, type );
    });
},

动画源码

这个队列是转为动画量身定制的,用 next 传递下一个动作,就好比是面试官让面试的人通知下一个人进来面试。

有一个队列,在执行第一个 animate 方法的时候加入队列就开始执行动画,因为动画自己在执行的时候就会产生异步的时间差。在这个时间差的里面继续去加入之后的动画 animate 进去队列,然后在每一个动画结束之后去取出队列中的第一个 animate 方法开始执行,依次循环下去。

实例 .animate() 源码:

// 外观方法,对每个elem添加动画到队列(默认"fx"队列,为false不加入队列直接执行)
animate: function( prop, speed, easing, callback ) {
    // 是否有需要动画的属性
    var empty = jQuery.isEmptyObject( prop ),
        optall = jQuery.speed( speed, easing, callback ),
        doAnimation = function() {
            // Operate on a copy of prop so per-property easing won't be lost
            // 执行动画,返回一个animation对象
            var anim = Animation( this, jQuery.extend( {}, prop ), optall );

            // Empty animations, or finishing resolves immediately
            // jQuery.fn.finish执行期间jQuery._data( this, "finish" )设置为"finish"
            // 所有动画创建后都必须立即结束到end,即直接运动到最终状态(后面详细讲)
            if ( empty || data_priv.get( this, "finish" ) ) {
                anim.stop( true );
            }
        };
        // 用于jQuery.fn.finish方法内判断 queue[ index ] && queue[ index ].finish。
        // 比如jQuery.fn.delay(type)添加到队列的方法没有finish属性,不调用直接舍弃
        doAnimation.finish = doAnimation;

    return empty || optall.queue === false ?
        // 直接遍历执行doAnimation
        this.each( doAnimation ) :
        // 遍历元素把doAnimation加入对应元素的optall.queue队列
        this.queue( optall.queue, doAnimation );
},

通过 queue 调度动画的之间的衔接,Animation 方法执行单个动画的封装。jQuery 在 queue 的调度上涉及了一个关键的处理:同步与异步代码同时执行,同步收集动画序列,异步调用序列

$('.trigger').animate({
    width: '500px'
}).animate({
    height:'100px'
});

通过多个 animate 方法形成动画链,那么这个动画链其实都是会加入到 queue 队列里面;在每一次 queue 方法中会把动画数据写到队列中,然后取出队列中的第一个序列通过 dequeue 方法执行;开始执行之前写一个进程锁“inprogress”到 queue 里面,代表这个动画还在执行中,防止同个序列的多个动画重复执行,这个就是异步执行同步收集的处理方案;此时动画开始了,这里注意动画是在异步执行的同步的代码,继续调用下一个 animate

队列头是有一把 “inprogress” 进程锁的,那么这时候动画只需要加入队列,但是可以通过 inprogress 是否存在来判断是否执行。

所有的 animate 方法在加入队列都是按照以上的逻辑依次执行,动画执行完毕了就会有一个结束通知,然后从 queue 取出第一个队列继续执行了,如此循环。

计时器

如果一个属性从20平滑到80,我们一般会这样计算它每次的增量,时间总共2s:

times = 2000 / 20; // 2秒即2000ms
every_increase = (80 - 20) / times;
setInterval(func, 20);

JavaScript是单线程的语言,setTimeoutsetInterval定时的向语言的任务队列添加执行代码,但是必须等到队列中已有的代码执行完毕,若遇到长任务,则拖延明显。js引擎在使用 setInterval() 时,仅当队列里没有当前定时器的任何其它代码实例时,才会被添加,而次数和值的累加都是需要函数执行才会生效,因此延迟也无法被追偿。当出现这种情况后,运动速度就不精确了。

怎么加强计时器呢?

// 计算当前流逝的比例,根据比例设置最终值(有定时器即可,与定时时间无关)
var remaining = Math.max(0, startTime + options.duration - createTime())
setInterval(func, 13);

优化了interval的调用。setInterval(func, 13) 由于js单线程机制不能保证每13ms会执行一次。通过createTime()与当前时间对比,动态算出变化尺度。通过这种方式也许原本期望tick执行10次,但浏览器在你延时时间内(比方说2000ms)时间内只给你调用了9次的情况下也能完整完成一个动画。

源码

在此之前,jq有一些动画的辅助工具:

jQuery.timers 当前正在运动的动画的tick函数堆栈
jQuery.fx.timer() 把tick函数推入堆栈。若已经是最终状态,则不加入
jQuery.fx.interval 唯一定时器的定时间隔
jQuery.fx.start() 开启唯一的定时器timerId
jQuery.fx.tick() 被定时器调用,遍历timers堆栈
jQuery.fx.stop() 停止定时器,重置timerId=null
jQuery.fx.speeds 指定了动画时长duration默认值,和几个字符串对应的值
jQuery.fx.off 是用在确定duration时的钩子,设为true则全局所有动画duration都会强制为0,直接到结束状态
// 所有动画的"每步运动tick函数"都推入timers
jQuery.timers = [];
jQuery.fx.tick = function() {
    var timer,
        i = 0,
        timers = jQuery.timers;

    fxNow = jQuery.now();// 当前时间毫秒

    for ( ; i < timers.length; i++ ) {
        timer = timers[ i ];
        // Checks the timer has not already been removed
        // 每个动画的tick函数(即此处timer)执行时返回remaining剩余时间,结束返回false
        // timers[ i ] === timer 的验证是因为可能有人恶意在tick函数中瞎整,删除jQuery.timers内项目
        if ( !timer() && timers[ i ] === timer ) {
            timers.splice( i--, 1 );
        }
    }
    // 无动画了,则stop掉全局定时器timerId
    if ( !timers.length ) {
        jQuery.fx.stop();
    }
    fxNow = undefined;
};

// 把动画的tick函数加入$.timers堆栈
jQuery.fx.timer = function( timer ) {
    jQuery.timers.push( timer );
    if ( timer() ) {
        jQuery.fx.start();
    } else {// 若已经在终点了,无需加入
        jQuery.timers.pop();
    }
};

jQuery.fx.interval = 13;// 全局定时器定时间隔
// 启动全局定时器,定时调用tick遍历$.timers
jQuery.fx.start = function() {
    if ( !timerId ) {
        timerId = setInterval( jQuery.fx.tick, jQuery.fx.interval );
    }
};
// 停止全局定时器timerId
jQuery.fx.stop = function() {
    clearInterval( timerId );
    timerId = null;
};
// speeds(即duration)默认值,和字符串的对应值
jQuery.fx.speeds = {
    slow: 600,
    fast: 200,
    // Default speed
    _default: 400
};

整个动画机制只使用一个统一的 setInterval ,把 tick 推入堆栈 jQuery.timers ,每次定时器调用 jQuery.fx.tick() 遍历堆栈里的函数,通过tick的返回值知道是否运动完毕,完毕的栈出,没有动画的时候就 jQuery.fx.stop() 暂停。 jQuery.fx.start() 开启定时器前会检测是开启状态,防止重复开启。每次把tick推入堆栈的时候都会调用 jQuery.fx.start() 。这样就做到了需要时自动开启,不需要时自动关闭。

关于参数的设定:

//设置参数统一为options对象
// 支持的参数类型(均为可选参数,只有fn会参数提前。无speed设为默认值,无easing在Tween.prototype.init中设为默认值)
jQuery.speed = function( speed, easing, fn ) {
    var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : {
        complete: fn || !fn && easing ||
            jQuery.isFunction( speed ) && speed,
        duration: speed,
        easing: fn && easing || easing && !jQuery.isFunction( easing ) && easing
    };
    // jQuery.fx.off控制全局的doAnimation函数生成动画的时长开关
    // 支持 "slow" "fast",无值则取默认400
    opt.duration = jQuery.fx.off ? 0 : typeof opt.duration === "number" ? opt.duration :
        opt.duration in jQuery.fx.speeds ? jQuery.fx.speeds[ opt.duration ] : jQuery.fx.speeds._default;

    // Normalize opt.queue - true/undefined/null -> "fx"
    // false不使用队列机制
    if ( opt.queue == null || opt.queue === true ) {
        opt.queue = "fx";
    }

    // Queueing
    opt.old = opt.complete;

    // 对opt.complete进行再封装,目的是该函数可以dequeue队列,让队列中下个doAnimation开始执行
    opt.complete = function() {
        if ( jQuery.isFunction( opt.old ) ) {
            opt.old.call( this );
        }

        if ( opt.queue ) {
            jQuery.dequeue( this, opt.queue );
        }
    };

    return opt;
};

queue队列是一个堆栈,比如elem的 "fx" 队列, jQuery.queue(elem, "fx") 即为缓存 jQuery._data(elem, "fxqueue") 。每个元素的 "fx" 队列都是不同的,因此不同元素或不同队列之间的动画是同步的,相同元素且相同队列之间的动画是异步的。添加到”fx”队列的函数若是队列中当前的第一个函数,将被直接触发,而添加到其他队列中的函数需要手动调用 jQuery.dequeue 才会启动执行。

如何设置添加的队列呢? jQuery.fn.animate 支持对象参数写法jQuery.fn.animate( prop, optall),通过 optall.queue 指定队列,未指定队列的按照默认值”fx”处理。speed、easing、callback均不是必须项,内部通过jQuery.speed将参数统一为对象optall。optall会被绑定上被封装过的optall.complete 函数,调用后执行dequeue调用队列中下一个doAnimation(后面会讲Animation执行完后如何调用complete自动执行下一个动画)

虽然加入了queue机制后,默认的动画顺序变为了异步而非同步。optall.queue 指定为false时,不使用queue队列机制,doAnimation将立即调用Animation执行动画,保留了原有的同步机制。

现在我们有了同步、异步两种方式,但在同步的时候,有可能出现重复触发某元素动画,而我们并不需要。在jq中按照场景可分为:

相同队列正在运动的动画
所有队列正在运动的动画
相同队列所有的动画
所有队列的动画
非队列正在运动的动画

停止动画分为两种状态:直接到运动结束位置、以当前位置结束。

并不是添加到队列的都是doAnimation,比如jQuery.fn.delay(),动画延迟函数:

jQuery.fn.delay = function( time, type ) {
    time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time;
    type = type || "fx";

    return this.queue( type, function( next, hooks ) {
        var timeout = setTimeout( next, time );
        hooks.stop = function() {
            // 取消延迟调用next
            clearTimeout( timeout );
        };
    });
};

由于没调用Animation,所以没有tick函数,自然没有anim.stop,从jq源码中可以看出,推荐在队列的hook上绑定 hooks.stop 停止函数(因此 stop/finish 中会调用hooks.stop)。queue队列中被执行的函数备注了的next函数(dequeue操作,调用下一个)和对应的hook对象($._data(type+’queuehook’)缓存,empty.fire用于自毁)和this(元素elem),因此可以通过next调用下一项。

清空动画队列

清空动画队列,调用 $(elems).queue( type, [] ) ,会替换队列为[],也可以事先保存队列,然后逐个执行,这正是 jQuery.fn.finish 的原理。

停止当前动画 $.fn.stop :

// 指定type,则该type   clearQueue gotoEnd
// type无值,则"fx" clearQueue,所有type gotoEnd
stop: function( type, clearQueue, gotoEnd ) {
    // 用于删除"非doAnimation"动画(没有tick函数加入timers堆栈全局interval执行,而是直接执行的
    var stopQueue = function( hooks ) {
        var stop = hooks.stop;
        delete hooks.stop;
        stop( gotoEnd );
    };
    // 参数提前,type=false当做"fx"处理
    if ( typeof type !== "string" ) {
        gotoEnd = clearQueue;
        clearQueue = type;
        type = undefined;
    }
    if ( clearQueue && type !== false ) {
        this.queue( type || "fx", [] );
    }
    // 遍历元素
    return this.each(function() {
        var dequeue = true,
            // type只有undefined和字符串两种可能
            index = type != null && type + "queueHooks",
            timers = jQuery.timers,
            data = data_priv.get( this );
        // 显式指定了队列,stop"非doAnimation"动画,并删除stop函数自身
        if ( index ) {
            if ( data[ index ] && data[ index ].stop ) {
                stopQueue( data[ index ] );
            }
        // type为undefined,遍历查找所有带有stop方法的所有队列的hook缓存属性,并调用删除
        // rrun = /queueHooks$/
        } else {
            for ( index in data ) {
                if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) {
                    stopQueue( data[ index ] );
                }
            }
        }
        // 对timers中全局interval正在进行的动画,对该元素该队列的执行stop(type为undefined则该元素的全部stop)
        for ( index = timers.length; index--; ) {
            if ( timers[ index ].elem === this && (type == null || timers[ index ].queue === type) ) {
                // gotoEnd为true直接到最终状态,为false停止在当前状态
                // gotoEnd为true,stop内部会调用run(1),并resolve触发promise,从而执行complete函数,从而dequeue下一个动画(Animation处会详细讲)
                // gotoEnd为false,就不会自动dequeue了,需要下面手动dequeue到下一个
                timers[ index ].anim.stop( gotoEnd );
                dequeue = false;
                timers.splice( index, 1 );
            }
        }

        // 后续的动画继续进行,如果还有并且没被clearQueue的话
        // 只有经过了元素动画stop的过程,且gotoEnd为true(内部dequeue过)才不需要手动dequeue
        // "非doAnimation"动画也是需要手动dequeue的
        if ( dequeue || !gotoEnd ) {
            jQuery.dequeue( this, type );
        }
    });
},

jQuery.fn.stop( type, clearQueue, gotoEnd ):type指定队列(false会变成”fx”,本方法不能停止非队列,需要使用jQuery.fn.finish(false));clearQueue为true为清除队列后续动画,false为不清除;gotoEnd为true表示直接到运动结束位置,false为当前位置结束.type无字符串值时,clearQueue, gotoEnd参数提前,type设为undefined。对于type为null/undefined的处理很特别。对”fx”按照clearQueue值处理,但是对元素所有队列动画都停止,按照goToEnd值处理。非队列动画不受影响。

所有动画直接到结束状态, $.fn.finish :

finish: function( type ) {
    // undefined/null变为"fx",false仍然是false
    if ( type !== false ) {
        type = type || "fx";
    }
    return this.each(function() {
        var index,
            data = data_priv.get( this ),
            // 先拿到队列堆栈,因为下面队列缓存将替换为[]
            queue = data[ type + "queue" ],
            hooks = data[ type + "queueHooks" ],
            timers = jQuery.timers,
            length = queue ? queue.length : 0;

        // 标记为finish阶段,此时所有的doAnimation执行时都会立即调用anim.stop(true),直接到动画结束的样子
        // 注意:由于js是单线程的,虽然这里data与哪个队列是无关的,看似其他type也被影响
        // 但其实即使全局interval的tick也必须等该函数执行完,那时data.finsh已经不在了
        data.finish = true;

        // Empty the queue first
        // 清空queue,这样下面的
        jQuery.queue( this, type, [] );
        // stop掉type对应的"非doAnimation"动画
        if ( hooks && hooks.stop ) {
            hooks.stop.call( this, true );
        }

        // 正在执行的动画anim.stop(true)直接到最终状态
        for ( index = timers.length; index--; ) {
            if ( timers[ index ].elem === this && timers[ index ].queue === type ) {
                timers[ index ].anim.stop( true );
                timers.splice( index, 1 );
            }
        }

        // 原来队列里的doAnimation函数遍历执行,data.finish为true,因此都会直接到运动结束状态
        for ( index = 0; index < length; index++ ) {
            if ( queue[ index ] && queue[ index ].finish ) {
                queue[ index ].finish.call( this );
            }
        }

        // Turn off finishing flag
        // 删除data.finsh标记
        delete data.finish;
    });
}

调用$(elems).queue( type, [] ),会替换队列为[];停止当前动画,jQuery.timers[ index ].anim.stop( gotoEnd )。gotoEnd为布尔值,指定停止动画到结束位置还是当前位置,通过timers[ index ].elem === this && timers[ index ].queue === type匹配队列和元素,从这里也能看出Animation函数中的单步运动tick函数需要绑定elem、anim、queue属性;anim是Animation返回的animation对象,stop函数用来结束当前动画。

jQuery.fn.finish( type ):type指定队列(默认”fx”,false表示非队列),执行过程中标记jQuery._data( this ).finish=true,清空queue队列,并且遍历执行队列中所有doAnimation函数(有finish属性的才是doAnimation函数)。由于缓存中带有finish标记,动画对象一创建就将调用anim.stop( true )

单个属性的运动对象 Tween

jQuery动画的核心逻辑就是 Animation( elem, properties, options ) ,会立即开始一个动画,把每个tick放入全局的jQuery.timers中。tick函数时多属性执行动画。jq把每个属性作为一个运动对象 Tween,把他们依次放入animation.tweens中(一个栈[])。然后用 tween.run() 来完成计算与设置。

/* 
 * 生成单个属性的运动对象
 * Tween.prototype.init.prototype = Tween.prototype;
 * jQuery.fx = Tween.prototype.init;
---------------------------------------------------------------------- */   
function Tween( elem, options, prop, end, easing ) {
    return new Tween.prototype.init( elem, options, prop, end, easing );
}
jQuery.Tween = Tween;

Tween.prototype = {
    constructor: Tween,
    // 初始化
    init: function( elem, options, prop, end, easing, unit ) {
        this.elem = elem;
        this.prop = prop;
        // 默认"swing"
        this.easing = easing || jQuery.easing._default;
        this.options = options;
        // 初始化时设置start,now与start相等
        this.start = this.now = this.cur();
        this.end = end;
        // 除了cssNumber中指定的可以为数字的属性,其它默认单位为px
        this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" );
    },
    // 计算当前样式值
    cur: function() {
        // 首先看是否有钩子
        var hooks = Tween.propHooks[ this.prop ];

        return hooks && hooks.get ?
            // 钩子有get方法
            hooks.get( this ) :
            // 默认处理
            Tween.propHooks._default.get( this );
    },
    run: function( percent ) {
        var eased,
            // 钩子
            hooks = Tween.propHooks[ this.prop ];

        if ( this.options.duration ) {
            // 时间过了百分之x,并不代表需要运动百分之x的距离,调用easing对应的函数
            // 可以在jQuery.easing中扩展运动函数,默认"swing"缓冲
            this.pos = eased = jQuery.easing[ this.easing ](
                percent, this.options.duration * percent, 0, 1, this.options.duration
            );
        } else {
            // duration为0,则percent一定为1,见tick函数中的计算
            this.pos = eased = percent;
        }
        // 计算当前应该运动到的值
        this.now = ( this.end - this.start ) * eased + this.start;

        // options对象可以指定step函数,每个tween调用一次,都会被执行
        if ( this.options.step ) {
            this.options.step.call( this.elem, this.now, this );
        }

        if ( hooks && hooks.set ) {
            // 钩子
            hooks.set( this );
        } else {
            // 默认
            Tween.propHooks._default.set( this );
        }
        return this;
    }
};

Tween.prototype.init.prototype = Tween.prototype;

Tween.propHooks = {
    _default: {
        get: function( tween ) {
            var result;

            // 非dom节点或者属性有值而style上无值的dom节点,均获取属性值返回
            // 注意:此处获取的值是带单位的
            if ( tween.elem.nodeType !== 1 ||
                tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) {
                return tween.elem[ tween.prop ];
            }

            // 获取起作用的prop属性样式值去掉单位。对于不可parseFloat的字符串则直接返回
            result = jQuery.css( tween.elem, tween.prop, "" );

            // ""、null、undefined、"auto"都按照0返回。此处值无单位
            return !result || result === "auto" ? 0 : result;
        },
        set: function( tween ) {

            // use step hook for back compat - use cssHook if its there - use .style if its
            // available and use plain properties where available

            // 可以自己在jQuery.fx.step中添加钩子,jq库中没有相关处理,是空对象{}
            if ( jQuery.fx.step[ tween.prop ] ) {
                jQuery.fx.step[ tween.prop ]( tween );

            // 凡是执行run的,之前一定执行过cur,调用默认get时,若执行了jQuery.css()则会把属性修正后的字符串缓存在jQuery.cssProps中,这说明elem.style[修正属性]一定存在,至少返回""
            // 在css样式机制的通用钩子cssHooks中的属性,也说明一定可以通过$.style设置
            } else if ( tween.elem.nodeType === 1 &&
                ( tween.elem.style[ jQuery.cssProps[ tween.prop ] ] != null ||
                    jQuery.cssHooks[ tween.prop ] ) ) {
                // 默认获取的样式值(除了属性上直接获取的)不带单位,所以加上unit设置
                jQuery.style( tween.elem, tween.prop, tween.now + tween.unit );

            // 通常对于非节点、get使用钩子的、get直接返回elem上属性的情况,都直接设置在属性上
            } else {
                tween.elem[ tween.prop ] = tween.now;
            }
        }
    }
};

// Support: IE <=9
// Panic based approach to setting things on disconnected nodes

Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = {
    set: function( tween ) {
        // 节点类型,并且有父节点(根元素也有父节点,为document)
        // 由于直接在属性上获取的值是带单位的,因此直接设置
        if ( tween.elem.nodeType && tween.elem.parentNode ) {
            tween.elem[ tween.prop ] = tween.now;
        }
    }
};

jQuery.easing = {
    // 线性运动
    linear: function( p ) {
        return p;
    },
    // 缓冲
    swing: function( p ) {
        return 0.5 - Math.cos( p * Math.PI ) / 2;
    },
    _default: "swing"
};

jQuery.fx = Tween.prototype.init;

// Back Compat <1.8 extension point
jQuery.fx.step = {};

Tween( elem, options, prop, end, easing )函数的构造和jq一样,另Tween.prototype.init.prototype = Tween.prototype,从而Tween()返回一个实例并能够使用原型方法cur、run。cur负责计算当前属性值,run需传入百分比,然后设置到对应的位置。duration是tweens中的tween公用,每步运动的百分比一致,在Animation的tick函数中处理。

每个属性运动的easing是可以不同的,options.easing可以定义公用样式,但优先级是低于options.specialEasing.prop这样对属性直接指定的,每个属性的easing属性可能不一样。options对象也会被传入,可以通过指定options.step函数,每个属性的tween调用都会执行一次,this指定为elem,传入参数now、tween。

cur和run中使用了Tween.propHooks[prop].set/get钩子。钩子代表例外,Tween.propHooks._default.get/set(tween)是标准的处理。scrollTop/scrollLeft有set钩子。对于通常使用动画的属性,非特殊需求需要钩子的确实几乎没有。


本文由 hongweipeng 创作,采用 知识共享署名 3.0,可自由转载、引用,但需署名作者且注明文章出处。

如果对您有用,您的支持将鼓励我继续创作!