jQuery parents()メソッド
例
<span> のすべての祖先要素を返します:
$(document).ready(function(){
$("span").parents().css({"({"color":"red","border":"2px solid red"});
});
$("span").parents().css({"({"color":"red","border":"2px solid red"});
});
Result:
body (great-great-grandparent)
div (great-grandparent)
- ul (grandparent)
- li (direct parent) span
試してみる »
定義と使い方
parents() メソッドは、選択された要素のすべての祖先要素を返します。
祖先とは、親、祖父、曾祖父などです。
DOM ツリー:このメソッドは、親要素から DOM 要素の祖先を上に向かって走査し、ドキュメントのルート要素(<html>)までのすべての経路を辿ります。
注意:filter パラメータが空の場合、このメソッドは直接の親要素から <body> および <html> までのすべての経路から、要素セット内のすべての祖先を選択します。そのため、検索結果の範囲を絞り込むセレクタ式を渡すと非常に便利です。
このメソッドとclosest()どちらも DOM ツリーを上に向かって走査しますが、相違点は次のとおりです:
parents()
- 親要素から開始する
- DOM ツリーに沿って上方向に走査し、渡された式に一致するすべての祖先を返します
- 0個、1個、または複数の要素を含む jQuery オブジェクトを返します
closest()
- 現在の要素から開始する
- DOM ツリーに沿って上方向に走査し、渡された式に一致する最初の祖先を返します
- 0個または1個の要素を含む jQuery オブジェクトを返します
その他の関連メソッド:
- parent()- 選択された要素の直接の親要素を返します
- parentsUntil()- 指定された2つの引数の間にあるすべての祖先要素を返します
構文
$(selector).parents(filter)
| パラメータ | 説明 |
|---|---|
| filter | 省略可能。祖先要素の検索範囲を絞り込むセレクタ式を指定します。 注意:複数の祖先を返す必要がある場合は、各式をカンマで区切ってください。 |
その他の例
検索範囲を絞り込む
filter パラメータを使用して、<span> のすべての祖先の中から <ul> 要素を返す方法。
複数の祖先を返す
filter パラメータを使用して、<span> のすべての祖先の中から <li> 要素と <div> 要素を返す方法。
タグ名による要素の祖先のデモ
<span> 要素の祖先を示します。
その他の拡張
jQuery 走査メソッド