jQuery学習チュートリアル19:jQuery遍歴-祖先


祖先は父、祖父、曽祖父などです.
jQueryでは、DOMツリーを上に移動して要素の祖先を検索できます.
DOMツリーを上へ
これらのjQueryメソッドは、DOMツリーを上に移動するのに役立ちます.
parent()
parents()
parentsUntil()
jQuery parent()メソッド
parent()メソッドは、選択した要素の直接親要素を返します.
この方法は,DOMツリーを1段上に遍歴するだけである.
次の例では、各要素の直接親要素を返します.
≪インスタンス|Instance|emdw≫







$(document).ready(function(){
  $("span").parent().css({"color":"red","border":"2px solid red"});
});




div ( )
    ul ( )
  • li ( ) span
div ( )

p ( ) span


jQuery parents()メソッド
parents()メソッドは、ドキュメントのルート要素()まで上に移動する選択された要素のすべての祖先要素を返します.
次の例では、すべての要素のすべての祖先を返します.
≪インスタンス|Instance|emdw≫







$(document).ready(function(){
  $("span").parents().css({"color":"red","border":"2px solid red"});
});



body (    )
  
div ( )
    ul ( )
  • li ( ) span

オプションのパラメータを使用して、祖先要素の検索をフィルタすることもできます.
次の例は、すべての要素のすべての祖先を返し、要素です.
≪インスタンス|Instance|emdw≫
$(document).ready(function(){
  $("span").parents("ul");
});

jQuery parentsUntil()メソッド
parentsUntil()メソッドは、2つの与えられた要素の間にあるすべての祖先要素を返します.
次の例では、エレメントとの間にあるすべての祖先エレメントを返します.
≪インスタンス|Instance|emdw≫
$(document).ready(function(){
  $("span").parentsUntil("div");
});

jQuery遍歴関数
jQuery遍歴関数には、要素をフィルタ、検索、直列に接続する方法が含まれます.
関数#カンスウ#
説明
.add()
一致する要素のセットに要素を追加します.
.andSelf()
スタック内の前の要素セットを現在のセットに追加します.
.children()
一致する要素セット内の各要素のすべてのサブ要素を取得します.
.closest()
要素自体から開始し、親要素に段階的に一致し、最初に一致した祖先要素を返します.
.contents()
テキストとアノテーションノードを含む、一致する要素セット内の各要素のサブ要素を取得します.
.each()
jQueryオブジェクトを反復し、一致する要素ごとに関数を実行します.
.end()
現在のチェーン内の最近のフィルタ処理を終了し、一致する要素のセットを前回の状態に戻します.
.eq()
一致する要素のセットを、指定したインデックスにある新しい要素に縮小します.
.filter()
一致する要素のセットを、一致するセレクタまたは一致する関数が値を返す新しい要素に縮小します.
.find()
現在の一致する要素セット内の各要素の子孫を取得し、セレクタによってフィルタされます.
.first()
一致する要素のセットをセット内の最初の要素に縮小します.
.has()
一致する要素のセットを、特定の要素を含む子孫のセットに縮小します.
.is()
セレクタに基づいて現在の一致要素のセットをチェックし、少なくとも1つの一致要素が存在する場合はtrueを返します.
.last()
一致する要素のセットをセット内の最後の要素に縮小します.
.map()
現在の一致セットの各要素を関数に渡し、戻り値を含む新しいjQueryオブジェクトを生成します.
.next()
一致するエレメントセット内の各エレメントに隣接する同世代エレメントを取得します.
.nextAll()
一致するエレメントセット内の各エレメントの後にあるすべての同世代エレメントを取得し、セレクタによってフィルタします(オプション).
.nextUntil()
一致するセレクタの要素に遭遇するまで、各要素の後にあるすべての同世代要素を取得します.
.not()
一致する要素セットから要素を削除します.
.offsetParent()
配置に使用する最初の親要素を取得します.
.parent()
現在の一致する要素セット内の各要素の親要素を選択してフィルタします(オプション).
.parents()
現在の一致する要素セット内の各要素の祖先要素を取得し、セレクタによってフィルタされます(オプション).
.parentsUntil()
現在の一致するエレメントセット内の各エレメントの祖先エレメントを、一致するセレクタのエレメントに遭遇するまで取得します.
.prev()
一致する要素のセット内の各要素が隣接する前の世代の要素を取得し、セレクタによってフィルタされます(オプション).
.prevAll()
一致する要素のセット内の各要素の前のすべての同世代要素を取得し、セレクタによってフィルタされます(オプション).
.prevUntil()
一致するセレクタの要素に遭遇するまで、各要素の前のすべての同世代要素を取得します.
.siblings()
一致するエレメントセット内のすべてのエレメントの同世代エレメントを取得し、セレクタによってフィルタされます(オプション).
.slice()
一致する要素のセットを指定した範囲のサブセットに縮小します.