nextUntilメソッド

nextUntilメソッドは、 指定された要素と同じ親要素内で、その要素の後方にある 要素を返します。このメソッドは、指定された要素から、 メソッドのパラメータとして指定されたセレクターに 最初に一致する要素までの間にある要素を返します。 メソッドにパラメータを渡さない場合、メソッドは nextAllメソッド として機能します。

構文

最初のパラメータとして、選択に使用する式を文字列、 DOMノード、またはjQueryオブジェクトで渡すことができます。 2番目のパラメータとして、文字列で表す追加のフィルター条件を 渡すことができます。どちらのパラメータもオプションです:

javascript.nextUntil([セレクター], [フィルター]);

例

要素#testを見つけ、 その要素の下方向の隣接要素のうち、 wwwクラスを持つ段落までに対して、 htmlメソッドを使用して テキスト'!'を設定してみましょう:

html<p>outside</p>
<div>
  <p>inside</p>
  <p class="www">inside</p>
  <p>inside</p>
  <p>inside</p>
  <p id="test">inside</p>
  <p>inside</p>
  <p>inside</p>
  <p class="www">inside</p>
  <p>inside</p>
</div>
<p>outside</p>
javascript$('#test').nextUntil('p.www').html('!');

HTMLコードは次のようになります:

html<p>outside</p>
<div>
  <p>inside</p>
  <p class="www">inside</p>
  <p>inside</p>
  <p>inside</p>
  <p id="test">inside</p>
  <p>!</p>
  <p>!</p>
  <p class="www">inside</p>
  <p>inside</p>
</div>
<p>outside</p>

関連項目

  • メソッドprevUntil,
    指定された要素の前方にある要素を返します
  • メソッドnext,
    要素の直後の隣接要素を取得できます
  • メソッドnextAll,
    指定された要素と同じ親要素内で、その要素の後方にある すべての要素を返します
  • メソッドsiblings,
    要素と同じ親要素内にあるすべての隣接要素を 取得できます