jQuery.addBack() 函數用法實例詳解

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() 函數用法實例詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章！