指定されたCSSセレクタに最も近い祖先要素を返します。

構文

1. Element = Element.closest( selectors )

引数

selectors省略可

有効なCSSセレクタを表す文字列

戻り値

selectorsに一致する最も近い祖先のElement オブジェクトまたは自分自身

Element オブジェクトを返すメソッド・プロパティ

Document.closest (DOM)

tagNameで指定したHTML要素、あるいはtagNameを認識できない場合HTMLUnknownElementを生成します。

Document.closest (DOM)

指定したタグ名およびネームスペースURIで、新しい要素を生成します。

Document.getElementById メソッド (DOM)

特定のidを持つエレメントへのオブジェクト参照を返します。

Document.closest (DOM)

指定したセレクターに一致する、文書内で最初の要素ノードを返します。

Document.closest (DOM)

文書の直接の子であるElementを返します。HTML文書では、これは通常は文書のhtml要素を表すHTMLElementオブジェクトになります。

HTMLCollection.closest (DOM)

HTMLコレクション内のインデックス番号で指定された位置にある要素を取得します。存在しないインデックス番号を指定した場合は、NOTHINGを返します。

HTMLCollection.closest (DOM)

引数に指定されたidを持つ要素を取得します。要素が見つからない場合NOTHINGを返します。

Element.closest メソッド

指定された CSSセレクタ に最も近い祖先要素を返します。

Attr.closest (DOM)

属性が所属する要素を返します。

使い方

targetクラスの要素から初めてparentクラスを持つ祖先要素を見つけるまで遡っていきます。見つからなかった場合は、nullを返します。

<div class="parent">
	<div class="child">
		<span class="target">Target Element</span>
	</div>
</div>

DIM Document = IE.Document
DIM targetElement = Document.querySelector(".target")

DIM Element = targetElement.closest(".parent")    // <div class="parent">...</div>