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 月