HTML DOM Element matches() 方法

定义和用法

matches() 方法将返回 true，如果元素匹配特定的 CSS 选择器；否则返回 false。

另请参阅：

完整的 CSS 选择器参考手册

Element closest() 方法

实例

例子 1

元素是否匹配某个 CSS 选择器？

const element = document.getElementById("demo");
let answer = element.matches(".container");

亲自试一试

例子 2

元素是否匹配两个选择器之一？

const element = document.getElementById("demo");
let answer = element.matches(".container, .wrapper");

亲自试一试

语法

element.matches(selectors)

参数

参数 描述
selectors

必需。一个或多个（逗号分隔）要匹配的 CSS 选择器。

返回的元素是文档中第一个找到的元素。

请参阅我们的完整的 CSS 选择器参考手册。

返回值

类型 描述
布尔值
  • true - 元素匹配 CSS 选择器
  • false - 元素与 CSS 选择器不匹配

浏览器支持

首个完全支持 matches() 方法的浏览器版本：

Chrome Edge Firefox Safari Opera
Chrome
33		 Edge
15		 Firefox
34		 Safari
7		 Opera
21
2014 年 2 月 2017 年 4 月 2014 年 12 月 2013 年 10 月 2014 年 5 月