jQuery.prevAll()関数の使い方を詳しく解説

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

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

この関数の反対は nextAll() 関数で、一致する各要素の後のすべての兄弟要素を選択するために使用されます。

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

構文

この関数は jQuery 1.2 の新しい関数です。

jQueryObject.prevAll( [ selector ] )

Parameters

パラメータの説明

selector Optional/StringSelector Stringを型で指定します。

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

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

戻り値

prevAll()関数の戻り値はjQuery型で、現在のjQueryオブジェクトの一致する各要素の前に指定されたセレクターに一致するすべての兄弟要素をカプセル化する新しいjQueryオブジェクトを返します。

一致する要素がない場合は、空の jQuery オブジェクトが返されます。

例と説明

次の HTML コードを例として取り上げます:

<p id="n1">
    <span id="n2">
        <span id="n3">A</span>
    </span>
    <strong id="n4" class="active">B</strong>
    <span id="n5" class="active">C</span>
    <label id="n6">D</label>
    <span id="n7">
        <span id="n8">E</span>
    </span>
</p>
<p id="n9">
    <span id="n10" class="active"></span>
    <label id="n11"></label>
    <span id="n12"></span>
</p>

次の jQuery サンプル コードは、prevAll() 関数の具体的な使用法を示すために使用されます:

//返回jQuery对象所有匹配元素的标识信息数组
//每个元素形如：#id
function getTagsInfo($doms){
    return $doms.map(function(){
        return "#" + this.id;
    }).get();
}
var $n6 = $("#n6");
//匹配n6之前所有的同辈元素
var $n6_prevAll = $n6.prevAll();
document.writeln( getTagsInfo( $n6_prevAll ) ); // #n5,#n4,#n2
//匹配n6之前的所有同辈strong元素
var $n6_prevAll_strong = $n6.prevAll("strong");
document.writeln( getTagsInfo( $n6_prevAll_strong ) ); // #n4
var $label = $("label");
//匹配所有label元素之前的包含类名"active"的同辈元素
var $label_prevAll_active = $label.prevAll(".active");
document.writeln( getTagsInfo( $label_prevAll_active ) ); // #n10,#n5,#n4

以上がjQuery.prevAll()関数の使い方を詳しく解説の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。