メソッド parentsUntil

メソッド parentsUntil は、 要素のすべての親要素を取得します。直接の親だけでなく、 祖父母、曽祖父母など、ルート要素(つまり html タグ)まで取得します。 ただし、このメソッドのパラメータで指定されたセレクタに一致する親要素に到達した時点で、親要素の検索は終了します。

構文

セレクタに一致する親要素まで親を検索します。セレクタにはDOMノード、式、jQueryオブジェクトを指定できます。 また、2番目のパラメータを使用して追加のフィルタリングを行うこともできます。両方のパラメータは省略可能です:

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

セレクタを指定しない場合、このメソッドはメソッド parents と同様に動作します:

javascript.parentsUntil();

例

要素 #test を見つけ、次にメソッド parentsUntil を使用して、クラス zzz を持つ要素までのすべての親要素を見つけ、メソッド prepend を使用してそれらにテキスト '!' を先頭に追加しましょう:

html<div>
  <div class="zzz">
    <div class="www">
      <div class="www">
        <p id="test">テキスト</p>
      </div>
    </div>
  </div>
</div>
javascript$('#test').parentsUntil('.zzz').prepend('!');

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

html<div>
  <div class="zzz">
    <div class="www">
      !
      <div class="www">
        !<p id="test">テキスト</p>
      </div>
    </div>
  </div>
</div>

関連項目

  • メソッド parent,
    要素の直接の親を取得できます
  • メソッド closest,
    セレクタに一致する最も近い親要素を取得できます
  • メソッド parents,
    要素のすべての親要素を取得できます
  • メソッド children,
    要素の子要素を取得できます