欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  web前端

jQuery.addBack() 函数用法实例详解

程序员文章站 2022-06-11 08:15:11
...
addBack()函数用于将之前匹配的元素加入到当前匹配的元素中,并以新的jQuery对象的形式返回。

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

你还可以使用选择器进一步缩小添加范围,只添加之前的jQuery对象中符合指定选择器的元素。

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

语法

jQuery 1.8 新增该函数。andSelf()函数是该函数的别名(从1.8开始,andSelf()函数已过时)。

jQueryObject.addBack( [ selector ] )

参数

参数

描述

selector 可选/String类型指定的选择器字符串

如果省略selector参数,则添加之前jQuery对象的所有匹配元素。

返回值

addBack()函数的返回值为jQuery类型,返回一个新的jQuery对象,该对象包含了当前jQuery对象的所有匹配元素以及创建当前jQuery对象的jQuery对象的匹配元素中符合指定选择器的元素。

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

从jQuery 1.8开始,andSelf()函数是该函数的别名。

细节说明:当一个jQuery对象被创建时,其内部有一个属性(prevObject)会保存创建它的jQuery对象的引用。调用addBack()函数时,当前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示例代码用于演示addBack()函数的具体用法:

//返回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的特定方法创建,使用addBack()将返回一个新的jQuery对象
//该对象所匹配的元素是$p和$label两者的匹配元素之和
var $pAndLabel = $label.addBack();
document.writeln( getTagsInfo( $pAndLabel ) ); // #n1,#n4,#n9,#n11
// 所有包含类名"active"的元素的上一个紧邻的同辈元素(#)
// 再加上所有包含类名"active"的元素中的span元素
var $elements =  $(".active").prev().addBack("span");
document.writeln( getTagsInfo( $elements ) ); // #n5,#n7,#n8,#n11,#n12
//addBack()之前有3个jQuery对象:
//第1个:$("p")
//第2个:$("p").find("strong")
//第3个:$("p").find("strong").siblings(".active")
//调用addBack()的是第3个对象,创建该对象的是第2个对象
//因此addBack()返回包含第3个对象和第2个对象的匹配元素之和的jQuery对象
var $matches = $("p").find("strong").siblings(".active").addBack();
document.writeln( getTagsInfo( $matches ) ); // #n7,#n8

以上就是jQuery.addBack() 函数用法实例详解的详细内容,更多请关注其它相关文章!