jQuery 源码解析(三) pushStack方法 详解

时间:2023-03-09 02:47:46
jQuery 源码解析(三) pushStack方法 详解

该函数用于创建一个新的jQuery对象,然后将一个DOM元素集合加入到jQuery栈中,最后返回该jQuery对象,有三个参数,如下:

  elems    Array类型 将要压入 jQuery 栈的数组元素,用于生成一个新的 jQuery 对象

  name    可选。 String类型 生成数组元素的 jQuery 方法名

  selector   可选。 Array类型 传递给 Query 方法的参数(用于序列化)

参数2和参数3可选的,用于设置返回的新的jQuery对象的selector属性

调用pushStack后之前的jQuery对象内的DOM引用是不会消失的,还保存到新的对象的prevObject里,我们可以通过end()来获取之前的jQuery对象,例如:

<!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 id="p1">今天天气很好</p><p id="p2">是吗</p>
<button id="b1">get News</button><button id="b2">get olds</button>
<script>
var a = $('p1');
b1.onclick=function(){
a=a.pushStack([p2],'Test','arg');
console.log(a);
}
b2.onclick=function(){
a=a.prevObject;
console.log(a)
}
console.log(a); //初始化时a.selector="p1"
</script>
</body>
</html>

渲染如下:

jQuery 源码解析(三) pushStack方法 详解

初始化时输出如下:

jQuery 源码解析(三) pushStack方法 详解

a保存的是p1这个DOM节点,然后点击get News,输出如下:

jQuery 源码解析(三) pushStack方法 详解

此时a中保存的p2这个DOM节点了,然后再点击get olds,输出如下:

jQuery 源码解析(三) pushStack方法 详解

又回到初始化的状态了

源码分析


writer by:大沙漠 QQ:22969969

pushStack定义在内部的jQuery.fn上,如下:

jQuery.fn = jQuery.prototype = {
/**/
pushStack: function( elems, name, selector ) { //创建一个新的空jQuery对象,然后把DOM元素集合放入这个jQuery对象中,并保留对当前jQuery对象的引用,该方法它为很多方法提供了支持。
// Build a new jQuery matched element set
var ret = this.constructor(); //构造一个新的空jQuery对象ret if ( jQuery.isArray( elems ) ) { //如果参数elems是数组,则借用数组方法push()插入
push.apply( ret, elems ); } else {
jQuery.merge( ret, elems ); //否则调用方法jQuery.merge( first, second ) 合并。
} // Add the old object onto the stack (as a reference)
ret.prevObject = this; //在新Query对象ret上设置属性prevObject,指向当前jQuery对象,从而形成一个链式栈 ret.context = this.context; if ( name === "find" ) {
ret.selector = this.selector + ( this.selector ? " " : "" ) + selector;
} else if ( name ) {
ret.selector = this.selector + "." + name + "(" + selector + ")"; //将name和selector保存到生成的jQuery对象的selector属性里,比如:.appendTo(p)
} // Return the newly-formed element set
return ret; //最后返回ret这个新的jQuery对象
},
/**/
};

就是内部创建创建一个新的jQuery对象并返回,通过prevObject属性来建立和之前的jQuery对象的链接而已。