HTML DOM Element closest() 方法

定義和用法

closest() 方法在 DOM 樹中搜索與指定 CSS 選擇器匹配的元素。

closest() 方法從元素本身開始，然后是祖先（父，祖元素，...），直到找到匹配項。

如果未找到匹配項，則 closest() 方法返回 null。

另請參閱：

完整的 CSS 選擇器參考手冊

Element matches() 方法

實例

例子 1

找到與 CSS 選擇器 ".container" 匹配的最接近的元素：

const element = document.getElementById("myElement");
const closest = element.closest(".container");

親自試一試

例子 2

Find the closest element that matches ".container" or ".wrapper":

const element = document.getElementById(".container, .wrapper");
const closest = element.closest(".container");

親自試一試

語法

element.closest(selectors)

參數

參數 描述
selectors

必需。一個或多個（逗號分隔的）要匹配的 CSS 選擇器。

請參閱我們的完整 CSS 選擇器參考手冊。

返回值

類型 描述
對象

與指定 CSS 選擇器匹配的最接近的祖先元素或元素本身。

如果沒有找到匹配項，則返回 null。

如果選擇器無效，則引發 SYNTAX_ERR 異常。

瀏覽器支持

首個完全支持 closest() 方法的瀏覽器版本：

Chrome Edge Firefox Safari Opera
Chrome
41		 Edge
15		 Firefox
35		 Safari
9		 Opera
28
2015 年 3 月 2017 年 4 月 2015 年 1 月 2015 年 10 月 2015 年 3 月