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 月