jQuery 過渡 - parentsUntil() メソッド

jQuery 遍历リファレンスマニュアル

例

<li class="item-a">の祖先要素を検索し、<ul class="level-1">まで行き、それらを赤い背景に設定します。同時に、<li class="item-2">のすべてのクラス名が"yes"の祖先要素を検索し、<ul class="level-1">まで行き、それらに青い枠線を設定します：

$("li.item-a");.parentsUntil(".level-1");
  .css("background-color", "red");
$("li.item-2");.parentsUntil($("ul.level-1"), ".yes");
  .css("border", "3px solid blue");

実際に試してみる

定義と用法

parentsUntil() は、現在のマッチング要素集合の各要素の祖先要素を取得し、セレクタ、DOMノード、またはjQueryオブジェクトに一致する要素まで（含まない）取得します。

文法 1

.parentsUntil(セレクタ,フィルタ)
パラメータ 説明
セレクタ オプション。文字列値で、祖先要素のマッチングを停止する場所を指定する選択子表現を定義します。
フィルタ オプション。文字列値で、要素に一致するための選択子表現を含みます。

文法 2

.parentsUntil(要素,フィルタ)
パラメータ 説明
要素 オプション。DOMノードまたはjQueryオブジェクトで、祖先要素のマッチングを停止する場所を指示します。
フィルタ オプション。文字列値で、要素に一致するための選択子表現を含みます。

詳細な説明

DOM要素集合を表すjQueryオブジェクトが与えられた場合、.parentsUntil() メソッドは、DOM木の中でこれらの要素の祖先要素を検索し、選択子（メソッドに渡されるパラメータ）に一致する要素に達するまでを許可します。返されるjQueryオブジェクトは、すべての祖先要素を含みますが、.parentsUntil() メソッドで指定された選択子に一致する要素を除きます。

一致しない場合や選択子が適用されていない場合、選択区域のすべての祖先要素を選択します；この場合、该方法が選択する要素は、選択子が提供されていない場合の .parents() と同じです。

jQuery 1.6では、.parentsUntil() メソッドの第1引数として、DOMノードまたはjQueryオブジェクトが選択子の代わりに使用できます。

このメソッドは、第2引数として選択子表現をオプションで受け入れます。このパラメータを適用すると、要素がその選択子に一致するかどうかを検出して要素をフィルタリングします。

jQuery 遍历リファレンスマニュアル