jQuery.siblings() 函數詳解

siblings()函數用於選取每個符合元素的所有同儕元素(不包括自己)，並以jQuery物件的形式傳回。

你也可以使用選擇器來進一步縮小選取範圍，篩選出符合指定選擇器的元素。

此函數屬於jQuery物件(實例)。

語法

jQueryObject.siblings( [ selector ] )

參數

參數 說明

#selector可選/String類型指定的選擇器字串。

siblings()函數會在目前jQuery物件每個符合元素的所有同儕元素中篩選出符合指定選擇器的元素。

如果省略selector參數，則選取每個符合元素的所有同儕元素。

傳回值

siblings()函數的回傳值為jQuery類型，傳回一個新的jQuery對象，該物件封裝了目前jQuery物件每個符合元素的所有符合指定選擇器的同儕元素。

如果沒有符合條件的元素，則傳回空的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範例程式碼用於示範siblings()函數的具體用法：

//返回jQuery对象所有匹配元素的标识信息数组
//每个元素形如：#id
function getTagsInfo($doms){
    return $doms.map(function(){
        return "#" + this.id;
    }).get();
}
var $n4 = $("#n4");
//匹配n4的所有同辈元素(同辈元素不会包括n4自己，下同)
var $elements = $n4.siblings( );
document.writeln( getTagsInfo( $elements ) ); // #n2,#n5,#n7,#n8
//匹配n4所有的同辈span元素
var $matches = $n4.siblings("span");
document.writeln( getTagsInfo( $matches ) ); // #n2,#n5,#n8
var $label = $("label");
//匹配所有label元素的含有类名"active"的同辈元素
var $actives = $label.siblings(".active");
document.writeln( getTagsInfo( $actives ) ); // #n7,#n8,#n12

以上是jQuery.siblings() 函數詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章！