siblings()函數用於選取每個符合元素的所有同儕元素(不包括自己),並以jQuery物件的形式傳回。
你也可以使用選擇器來進一步縮小選取範圍,篩選出符合指定選擇器的元素。
此函數屬於jQuery物件(實例)。
語法
jQueryObject.siblings( [ selector ] )
參數
參數 #sel可選/
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中文網其他相關文章!