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 月