CodePlayer

andSelf()函数用于将之前匹配的元素加入到当前匹配的元素中，并以新的jQuery对象的形式返回。

当前jQuery对象可能是通过调用其它jQuery对象的特定方法创建的，使用该函数将返回一个新的jQuery对象，该对象包含了当前jQuery对象和之前创建它的jQuery对象的所有匹配元素。

该函数属于jQuery对象(实例)。

语法

jQuery 1.2 新增该函数，但从1.8 开始被标记为已过时。从jQuery 1.8开始，请使用addBack()函数替代该函数。

jQueryObject.andSelf( )

返回值

andSelf()函数的返回值为jQuery类型，返回一个新的jQuery对象，该对象包含了当前jQuery对象和创建它的jQuery对象所匹配的所有元素。

如果没有匹配的元素，则返回空的jQuery对象。

从jQuery 1.8开始，andSelf()函数是addBack()函数的别名。

细节说明：当一个jQuery对象被创建时，其内部有一个属性( prevObject)会保存创建它的jQuery对象的引用。调用 andSelf()函数时，当前jQuery和创建它的jQuery对象会通过 add()函数连接起来，并返回一个新的jQuery对象。

示例&说明

以下面这段HTML代码为例：

<p id="n1">
	<span id="n2">
		<span id="n3">A</span>
	</span>
	<label id="n4">B</label>
	<span id="n5">
		<span id="n6">C</span>
	</span>
	<strong id="n7" class="active">D</strong>
	<span id="n8" class="active">E</span>
</p>
<p id="n9">
	<span id="n10"></span>
	<label id="n11"></label>
	<span id="n12" class="active"></span>
</p>

以下jQuery示例代码用于演示andSelf()函数的具体用法：

//返回jQuery对象所有匹配元素的标识信息数组
//每个元素形如：#id
function getTagsInfo($doms){
	return $doms.map(function(){
		return "#" + this.id;
	}).get();
}

//匹配所有的p元素
var $p = $("p");
// 选取所有p元素的后代label元素
var $label = $p.find("label");
// 由于jQuery对象$label是通过$p的特定方法创建，使用andSelf()将返回一个新的jQuery对象
// 该对象所匹配的元素是$p和$label两者的匹配元素之和
var $pAndLabel = $label.andSelf();
document.writeln( getTagsInfo( $pAndLabel ) ); // #n1,#n4,#n9,#n11


// 所有包含类名"active"的span元素和它们的上一个紧邻的同辈元素
var $elements =  $("span.active").prev().andSelf();
document.writeln( getTagsInfo( $elements ) ); // #n7,#n8,#n11,#n12


// andSelf()之前有3个jQuery对象：
// 第1个：$("p")
// 第2个：$("p").find("strong")
// 第3个：$("p").find("strong").siblings(".active")
// 调用andSelf()的是第3个对象，创建该对象的是第2个对象
// 因此andSelf()返回包含第3个对象和第2个对象的匹配元素之和的jQuery对象
var $matches = $("p").find("strong").siblings(".active").andSelf();
document.writeln( getTagsInfo( $matches ) ); // #n7,#n8

运行代码