jQuery closest()メソッド
例
<span> の最初の祖先要素を返します。これは <ul> 要素です:
$(document).ready(function(){
$("span").closest("ul").css({"color":"red","border":"2px solid red"});
});
試してみる »
定義と使い方
closest() メソッドは、選択された要素の最初の祖先要素を返します。
祖先とは、親、祖父、曽祖父など、そのように続きます。
DOM ツリー:このメソッドは、現在の要素から上方向へ、ドキュメントのルート要素(<html>)までのすべてのパスをたどって、最初の祖先要素を検索します。
このメソッドはparents()類似しており、どちらも DOM ツリーを上方向に走査しますが、相違点は次のとおりです:
closest()
- 現在の要素から開始する
- DOM ツリーを上方向に走査し、渡された式に一致する最初の単一の祖先を返します
- ゼロまたは 1 つの要素を含む jQuery オブジェクトを返します
parents()
- 親要素から開始する
- DOM ツリーを上方向に走査し、渡された式に一致するすべての祖先を返します
- ゼロ、1 つ、または複数の要素を含む jQuery オブジェクトを返します
その他の関連メソッド:
- parent()- 選択された要素の直接の親要素を返します
- parentsUntil()- 2 つの指定された引数の間にあるすべての祖先要素を返します
構文
選択された要素の最初の祖先要素を返します:
$(selector).closest(filter)
DOM コンテキストを使用して検索した DOM ツリー内の最初の祖先要素を返します:
$(selector).closest(filter,context)
| 引数 | 説明 |
|---|---|
| filter | 必須。祖先要素の検索範囲を絞り込むためのセレクター式、要素、または jQuery オブジェクトを指定します。 |
| context | 省略可能。その中で一致する要素を見つけることができる DOM 要素。 |
その他の例
<span> の最初の祖先要素を返します。これは <span> 要素です
このメソッドは現在の要素から開始するため、<span> の最初の <span> を検索すると、<span> が返されます。
DOM 要素をコンテキストとして渡して、最初の祖先要素を検索します
2 つの引数を使用して DOM 要素をコンテキストとして渡し、最初の <ul> 要素を検索します。
その他の拡張
jQuery 走査メソッド