jQuery.siblings() 関数の使用法の詳細

siblings() 関数は、一致する各要素のすべての兄弟要素 (それ自体を除く) を選択し、それを jQuery オブジェクトの形式で返すために使用されます。

セレクターを使用して、選択範囲をさらに絞り込み、指定したセレクターに一致する要素をフィルターで除外することもできます。

この関数はjQueryオブジェクト(インスタンス)に属します。

構文

jQueryObject.siblings( [ selector ] )

パラメータ

パラメータの説明

selector オプション/String型指定のセレクタString。

siblings() 関数は、現在の jQuery オブジェクト内の一致する各要素のすべての兄弟要素の中から、指定されたセレクターに一致する要素をフィルターします。

セレクターパラメーターが省略された場合、一致する各要素のすべての兄弟要素が選択されます。

戻り値

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 サンプル コードは、兄弟() 関数の具体的な使用法を示すために使用されます:

//返回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 中国語 Web サイトの他の関連記事を参照してください。