jQuery.andSelf()函數用法解析

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中文網其他相關文章！