jQuery 遍历 - nextUntil() メソッド
例
次の <dt id="term-2"> まで続く同胞要素を探し、それらを赤い背景色に設定します。同時に、<dt id="term-1"> の <dd> 同胞要素を <dt id="term-3"> まで探し、それらに青いテキスト色を設定します。
$("#term-2").nextUntil("dt").css("background-color", "red"); var term3 = document.getElementById("term-3"); $("#term-1").nextUntil(term3, "dd").css("color", "blue");
定義と使用法
nextUntil() は、各要素のすべての続く同胞要素を取得しますが、選択子、DOM ノード、または渡された jQuery オブジェクトに一致する要素を含みません。
文法 1
.nextUntil(selector,フィルタ)
パラメータ | 説明 |
---|---|
selector | 続く同胞要素の一致を停止する場所を示す選択子表現を含む文字列値 |
フィルタ | 要素に一致するために使用される選択子表現を含む文字列値 |
文法 2
.nextUntil(element,フィルタ)
パラメータ | 説明 |
---|---|
element | 続く同胞要素の一致を停止する場所を示す DOM ノードまたは jQuery オブジェクト |
フィルタ | 要素に一致するために使用される選択子表現を含む文字列値 |
詳細な説明
DOM 元素集合を表す jQuery オブジェクトが指定されている場合、.nextUntil() メソッドは、その引数に一致する要素に達するまで DOM 木の中の要素の続く同胞を検索します。返される新しい jQuery オブジェクトは、すべての続く同胞要素を含みますが、引数に一致する要素を含みません。
選択子に一致しない場合または選択子が指定されていない場合、すべての続く同胞を選択します;フィルタリングする選択子を提供しない場合、このメソッドが選択する要素は .nextAll() メソッドと同じです。
jQuery 1.6では、.nextUntil() メソッドには DOM ノードまたは jQuery オブジェクトを選択子の代わりに渡すことができます。
このメソッドは、第2引数として選択子表現をオプションで受け取ります。この引数が指定されている場合、要素がその選択子に一致するかどうかを検出して、それらをフィルタリングします。