parentsUntil()

parentsUntil()は先祖要素に属するjQueryオブジェクトを検索できるメソッドです。

次のようなHTMLがあったとします。

<div id="d1">
	<div id="d2">
		<div id="d3" class="c">
			<div id="d4"></div>
		</div>
	</div>
</div>

次のスクリプトでは#d3の先祖要素である#d1と#d2のjQueryオブジェクトを返します。

$("#d3").parentsUntil().css("border-color","red");

parentsUntil()の引数には先祖要素をどこまで検索するか指定できます。次のスクリとでは#d3の先祖要素である#d1と#d2から#d1までのjQueryオブジェクト、つまり#d2のjQueryオブジェクトを返します。

$("#d3").parentsUntil("#d1").css("background","blue");

parentsUntil()の第２引数には絞り込む要素をセレクタで絞り込むことができます。次のセレクタでは#d4〜#d1の間の先祖要素でclass属性「c」をもつ要素、つまり「#d3」のみのjQueryオブジェクトを返します。

$("#d4").parentsUntil("#d1",".c").css("border-left","10px solid #CCC");

parentsUntil()はjQuery 1.4.0で追加されたメソッドです。

jQuery 1.6.0から終了先祖要素の指定にjQuery オブジェクトやDOMオブジェクトを指定することが可能になりました。

登録日 : 2013年03月24日最終更新日 : 2013年3月24日

jQuery リファレンス