HTML DOMのclosest()メソッド
❮要素オブジェクト例
CSSセレクターに一致する最も近い要素を見つけて、黄色の境界線を付けます。
var element = document.getElementById("myElement");
var closest =
element.closest(".container");
if (closest) {
closest.style.border = "10px solid yellow";
}
定義と使用法
このclosest()
メソッドは、指定されたCSSセレクターに一致する最も近い要素をDOMツリーで検索します。要素自体から開始し、一致するものが見つかるまで親、祖父母などをテストします。一致するものが見つからない場合、このメソッドはnullを返します。
ブラウザのサポート
表の数字は、このメソッドを完全にサポートする最初のブラウザバージョンを示しています。
Method | |||||
---|---|---|---|---|---|
closest() | 41.0 | 15.0 | 35.0 | 6.0 | 28.0 |
構文
element.closest(selectors)
パラメータ値
Parameter | Description |
---|---|
selectors |
Required. Specifies one or more CSS selectors to match the element. These are used to select HTML elements based on their id, classes, types, attributes, values of attributes, etc. For multiple selectors, separate each selector with a comma. The returned element depends on which element that is first found in the document. Tip: For a list of all CSS Selectors, look at our CSS Selectors Reference. |
技術的な詳細
戻り値: |
指定されたCSSセレクターに一致する最も近い祖先要素または要素自体。一致するものが見つからない場合は、nullが返されます。 指定されたセレクターが無効な場合、SYNTAX_ERR例外をスローします。 |
---|
関連ページ
JavaScriptリファレンス:element.matches()メソッド。
❮要素オブジェクト