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

jQuery.siblings() 函数详解

程序员文章站 2022-04-03 13:53:42
...
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() 函数详解的详细内容,更多请关注其它相关文章!