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
以上是jQuery.andSelf()函数用法解析的详细内容。更多信息请关注PHP中文网其他相关文章!