jQuery 遍历 - prevUntil() メソッド
例
dt id="term-2" が前の同胞要素まで、これらを赤色に設定します。同時に、dt id="term-3" 前の dd 同胞を検索し、dt id="term-1" まで続け、それらを青いテキストに設定します:
$("#term-2").prevUntil("dt").css("background-color", "red"); var term1 = document.getElementById('term-1'); $("#term-3").prevUntil(term1, "dd").css("color", "green");
定義と使用法
prevUntil() メソッドは、現在のマッチング要素集合の各要素の前の同胞要素を取得しますが、選択子、DOMノード、またはjQueryオブジェクトに一致する要素を除きます。
文法 1
.prevUntil(選択子, フィルタ)
パラメータ | 説明 |
---|---|
選択子 | オプション。前方同胞要素のマッチングをどこで停止するかを示す選択子表現を含む文字列値。 |
フィルタ | オプション。要素に一致するための選択子表現を含む文字列値。 |
文法 2
.prevUntil(要素, フィルタ)
パラメータ | 説明 |
---|---|
要素 | オプション。前方同胞要素のマッチングをどこで停止するかを示すDOMノードまたはjQueryオブジェクト。 |
フィルタ | オプション。要素に一致するための選択子表現を含む文字列値。 |
詳細な説明
DOM要素集合を表すjQueryオブジェクトが指定されている場合、.prevUntil() メソッドは、DOM木の中でこれらの要素の前の同胞要素を検索し、選択子(メソッドに渡されるパラメータ)に一致する要素に達するまで続けます。返されるjQuery新しいオブジェクトは、すべての前の同胞要素を含みますが、.prevUntil() メソッドで指定された選択子に一致する要素を除きます;返される要素の順序は、最も近い同胞要素から最も遠い同胞要素までです。
一致しない場合または選択子が適用されていない場合、選択範囲のすべての前の同胞要素を選択します;この場合、该方法で選択される要素は、選択子が提供されていない場合の .prevAll() と同じです。
jQuery 1.6では、.prevUntil() メソッドの第一引数には、選択子ではなく、DOMノードまたはjQueryオブジェクトを使用できます。
このメソッドは、オプションの選択子表現を第二引数として受け取ります。このパラメータが適用されている場合、要素が選択子に一致するかどうかを検出して要素をフィルタリングします。