队列是常用的数据结构之一，只允许在表的前端(队头)进行删除操作(出队)，在表的后端(队尾)进行插入操作(入队)。特点是先进先出，最先插入的元素最先被删除。

在jQuery内部，队列模块为动画模块提供基础功能，负责存储动画函数、自动出队并执行动画函数，同时还要确保动画函数的顺序执行。

jQuery的静态方法含有如下API:

  • $.queue(elem,type,data)　;返回或修改匹配元素关联的队列,返回最新的队列，参数如下:

　　　　　　　　　　　　　　　  elem 　　;DOM元素或JavaScript对象

　　　　　　　　　　　　　　　　type 　　;队列名称，默认是标准动画fx

　　　　　　　　　　　　　　　　data　　;需要设置的队列函数，可以是空(返回队列)、函数(加入队列)或函数数组(替换队列)

  • $.dequeue(elem,type) 　　;用于出队并执行匹配元素关联的函数队列中的下一个元素

　　　　　　　　　　　　　　　　elem　　;DOM元素或JavaScript对象

　　　　　　　　　　　　　　　　type　　;是队列名称，默认为动画队列fx

writer by:大沙漠 QQ:22969969

jQuery/$ 实例方法(可以通过jQuery实例调用的):

  • queue(type,data)  　　    ;返回第一个匹配元素的函数队列，或修改所有匹配的元素关联的函数队列，参数如下:

　　　　　　　　　　　　　　　　type　　;队列名称

　　　　　　　　　　　　　　　　data　　;data是可选的函数或函数数组，参数同$.queue()的第三个参数

  • dequeue(type)　　　　   ;出队并执行所有匹配元素关联的函数队列中的下一个函数
  • delay(time,type) 　　       ;延迟函数出队执行。通过调用.queue(type,data)向关联的函数队列中插入一个新的函数，在函数内通过setTimeout()延迟下一个函数的出队时间。
  • clearQueue(type)        　 ;移除匹配元素关联的函数队列中的所有未被执行的函数，内部代码就一句:return this.queue( type || "fx", [] );

举个栗子:

<!DOCTYPE html>

<html lang="en">

<head>

    <meta charset="UTF-8">

    <title>Document</title>

    <script src="http://libs.baidu.com/jquery/1.7.1/jquery.min.js"></script>

</head>

<body>

    <p>123</p>

    <script>

        function f1(){console.log('f1触发');}　　　 //定义两个测试函数

        function f2(){console.log('f2触发')};

        $('p').queue('test',f1);               　　//将f1入队，队列名称为test

        $('p').dequeue('test');            　　　　//将匹配元素的名称为test的函数列表出队并执行

        $('p').queue(f2);            　　　　　　　 //将f2放入p匹配元素的队列中，默认为动画队列，会自动执行。

    </script>

</body>

</html>

输出如下:

源码分析

jQuery的队列是基于数据缓存模块$.data来实现的，当调用$.queue()时回把函数列表以队列名+'queue'为属性，保存在对应的DOM元素的内部缓存对象上，例如:

<!DOCTYPE html>

<html lang="en">

<head>

    <meta charset="UTF-8">

    <title>Document</title>

    <script src="http://libs.baidu.com/jquery/1.7.1/jquery.min.js"></script>

</head>

<body>

    <p>123</p>

    <script>

        function f1(){console.log('f1触发');}

        $('p').queue('test',f1);

    </script>

</body>

</html>

我们可以在控制台里直接从$.cache里获取对应的属性，如下:

document.getElementsByTagName('p')[0][$.expando]就是例子里p元素节点对象的$.expando属性，该属性的值会作为$.cache的某个属性，存储着对应这个p元素的数据缓存对象(这是数据缓存模块的内容)

$.queue和$.dequeue的实现如下:

jQuery.extend({

    /*略*/

    queue: function( elem, type, data ) {            //返回或修改匹配元素关联的队列。elem是DOM元素或JavaScript对象，type是队列名称，data是可选的函数或函数数组

        var q;

        if ( elem ) {

            type = ( type || "fx" ) + "queue";                //修正参数type,默认为动画队列fx,在参数type后面加上queue表示这是一个队列

            q = jQuery._data( elem, type );                    //取出参数type对应的队列 如果之前有数据则返回该数组 否则 q等于undefined

            // Speed up dequeue by getting out quickly if this is just a lookup

            if ( data ) {                                    //如果传入了data参数

                if ( !q || jQuery.isArray(data) ) {                //如果type队列不存在，或者type队列存在且data是一个数组

                    q = jQuery._data( elem, type, jQuery.makeArray(data) );    //调用jQuery.makeArray把参数data转换为数组并替换队列

                } else {

                    q.push( data );                                //队列存在且data不是一个数组则调用数组push方法把参数data放入队列

                }

            }

            return q || [];

        }

    },

    dequeue: function( elem, type ) {                //用于出队并执行匹配元素关联的函数队列中的下一个元素

        type = type || "fx";                            //修正参数type,默认是"fx";

        var queue = jQuery.queue( elem, type ),            //获取elem元素的type队列

            fn = queue.shift(),                            //调用shift方法取出队列第一个函数

            hooks = {};                                    //存放出队的函数在执行时的数据

        // If the fx queue is dequeued, always remove the progress sentinel

        if ( fn === "inprogress" ) {                    //如果出队的是占位符"inprogress"，则丢弃再从队列头部出一个，只有动画队列会设置占位符"inprogress"

            fn = queue.shift();

        }

        if ( fn ) {

            // Add a progress sentinel to prevent the fx queue from being

            // automatically dequeued

            if ( type === "fx" ) {                        //如果是动画队列

                queue.unshift( "inprogress" );                //则在队列开头添加一个占位符"inprogress"，表示动画函数正在执行当中

            }

            jQuery._data( elem, type + ".run", hooks );    //设置内部数据type+".run",表示参数type对应的队列正在执行，值是hooks，它会被作为第二个参数传递给出队的函数

            fn.call( elem, function() {

                jQuery.dequeue( elem, type );

            }, hooks );                                    //调用函数方法call执行出队的函数，elem是函数执行的上下文，即关键词this指向的对象;第二个参数是封装了jQuery.dequeue( elem, type )的函数，不会自动执行，需要在出队的函数返回前手动调用next()

        }

        if ( !queue.length ) {                            //如果参数type对应的队列在出队后成为空队列，即所有函数都已经出队并执行

            jQuery.removeData( elem, type + "queue " + type + ".run", true );        //调用jQuery.removeData()方法移除参数type对应的数据缓存对象

            handleQueueMarkDefer( elem, type, "queue" );                            //检查匹配元素关联的队列(type+"queue")和计数器(type+"mark")是否完成，如果完成则触发方法.promise()中的计数器

        }

    }

});

type默认等于fx，jQuery的动画效果也是基于Queue实现的，这个fx默认就是动画效果，对于jQuery/$ 实例方法来说，它是调用jQuery的静态方法来实现的，如下:

jQuery.fn.extend({

    queue: function( type, data ) {            //返回第一个匹配元素的函数队列，或修改所有匹配的元素关联的函数队列。type是队列名称，默认是fx。data参数等同于jQuery.queue中的data参数

        if ( typeof type !== "string" ) {        //修正参数    当传入的格式是queue()或queue(data) (注:data可以是函数或函数数组)时

            data = type;

            type = "fx";

        }

        if ( data === undefined ) {                //如果没有传入data参数，

            return jQuery.queue( this[0], type );    //则调用jQuery.queue()返回第一个匹配元素上参数type对应的队列

        }

        return this.each(function() {            //如果传入了data参数

            var queue = jQuery.queue( this, type, data );        //为每一个匹配元素调用jQuery.queue( this, type, data ),把参数(函数)入队，或者用参数data(函数数组)替换队列。

            if ( type === "fx" && queue[0] !== "inprogress" ) {    //对于动画队列fx，且没有动画函数正在执行,则立即出队并执行动画函数。

                jQuery.dequeue( this, type );

            }

        });

    },

    dequeue: function( type ) {                    //出队并执行匹配元素关联的函数队列中的下一个函数

        return this.each(function() {

            jQuery.dequeue( this, type );

        });

    },

    /*略*/

})

jQuery 源码分析(十一) 队列模块 Queue详解的更多相关文章

  1. jQuery 源码分析(十八) ready事件详解

    ready事件是当DOM文档树加载完成后执行一个函数(不包含图片,css等),因此它的触发要早于load事件.用法: $(document).ready(fun) ;fun是一个函数,这样当DOM树加 ...

  2. jQuery 源码分析(二) 入口模块

    jQuery返回的对象本质上是一个JavaScript对象,而入口模块则可以保存对应的节点的引用,然后供其它模块操作 我们创建jQuery对象时可以给jQuery传递各种不同的选择器,如下: fals ...

  3. jQuery 源码分析(十七) 事件系统模块 实例方法和便捷方法 详解

    实例方法和便捷方法是指jQuery可以直接通过链接操作的方法,是通过调用$.event上的方法(上一节介绍的底层方法)来实现的,常用的如下: on(types,selector,data,fn,one ...

  4. Netty源码分析之Reactor线程模型详解

    上一篇文章,分析了Netty服务端启动的初始化过程,今天我们来分析一下Netty中的Reactor线程模型 在分析源码之前,我们先分析,哪些地方用到了EventLoop? NioServerSocke ...

  5. vuex 源码分析(七) module和namespaced 详解

    当项目非常大时,如果所有的状态都集中放到一个对象中,store 对象就有可能变得相当臃肿. 为了解决这个问题,Vuex允许我们将 store 分割成模块(module).每个模块拥有自己的 state ...

  6. ZRender源码分析5：Shape绘图详解

    回顾 上一篇说到:ZRender源码分析4:Painter(View层)-中,这次,来补充一下具体的shape 关于热区的边框 以圆形为例: document.addEventListener('DO ...

  7. Jvm(jdk8)源码分析1-java命令启动流程详解

    JDK8加载源码分析 1.概述 现在大多数互联网公司都是使用java技术体系搭建自己的系统,所以对java开发工程师以及java系统架构师的需求非常的多,虽然普遍的要求都是需要熟悉各种java开发框架 ...

  8. 10.Spark Streaming源码分析:Receiver数据接收全过程详解

    原创文章,转载请注明:转载自 听风居士博客(http://www.cnblogs.com/zhouyf/)   在上一篇中介绍了Receiver的整体架构和设计原理,本篇内容主要介绍Receiver在 ...

  9. mybatis 源码分析（三）Executor 详解

    本文将主要介绍 Executor 的整体结构和各子类的功能,并对比效率: 一.Executor 主体结构 1. 类结构 executor 的类结构如图所示: 其各自的功能: BaseExecutor: ...

随机推荐

  1. linux 启动jar包 指定yml配置文件和输入日志文件

    命令为: nohup java -jar project.jar  --spring.config.location=/home/project-conf/application.yml >  ...

  2. Github(第一次尝试)

    重要提示:项目中的文件最好最好不要出现中文,尤其是复杂的中文文件名. 前提:本地已经用git 管理 一个测试项目(项目一),分支为master. 1.注册 github: http://git.osc ...

  3. jxl.jar下载

    jxl.jar是通过java操作excel表格的工具类库,是由java语言开发而成的. 在网上找了很多,不是链接失效,就是csdn上要钱的,所以干脆上传个到自己的博客文件里,方便你们下载. 下载地址: ...

  4. Nim 游戏

    你和你的朋友,两个人一起玩 Nim 游戏:桌子上有一堆石头,每次你们轮流拿掉 1 - 3 块石头. 拿掉最后一块石头的人就是获胜者.你作为先手. 你们是聪明人,每一步都是最优解. 编写一个函数,来判断 ...

  5. Django信号机制相关解释与示例

    Django 信号# django自带一套信号机制来帮助我们在框架的不同位置之间传递信息.也就是说,当某一事件发生时,信号系统可以允许一个或多个发送者(senders)将通知或信号(signals)发 ...

  6. Mac--ModuleNotFoundError: No module named 'magic'

    关于Mac本报错“ ModuleNotFoundError: No module named 'magic' ” 作为一个python程序员,简单粗暴pip install python-magic ...

  7. linux下录屏和回放工具script和scriptreplay

    读书是一个长见识的过程,以前偶尔会用到录屏的工具,很少用想系统的学习一下.最近看了linux shell脚本攻略,发现很多新东西是以前自己没有接触到的.比如,这个非常好用的录屏工具:script,这次 ...

  8. pip安装插件报错。

    报错: Cannot unpack file C:\Windows\TEMP\pip-unpack-4mbfczpj\simple (downloaded from C:\Windows\TEMP\p ...

  9. RocketMQ 升级到主从切换(DLedger、多副本)实战

    目录 1.RocketMQ DLedger 多副本即主从切换核心配置参数详解 2.搭建主从同步环境 3.主从同步集群升级到DLedger 3.1 部署架构 3.2 升级步骤 3.3 验证消息发送与消息 ...

  10. Python菜鸟文本处理4种方法

    自从认识了python这门语言,所有的事情好像变得容易了,作为小白,逗汁儿今天就为大家总结一下python的文本处理的一些小方法. 话不多说,代码撸起来. python大小写字符互换 在进行大小写互换 ...