DOMTokenList:contains() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

contains() 方法是 DOMTokenList 介面的一個方法,它返回一個布林值——如果底層列表包含給定的 token,則返回 true,否則返回 false

語法

js
contains(token)

引數

token

一個代表您想在列表中檢查其存在的 token 的字串。

返回值

一個布林值,如果呼叫列表包含 token,則為 true,否則為 false

示例

在下面的示例中,我們使用 Element.classList 檢索設定在 <span> 元素上的類列表,該列表是 DOMTokenList。然後,我們測試列表中是否存在 "c",並將結果寫入 <span>Node.textContent

首先,HTML 程式碼

html
<span class="a b c"></span>

現在是 JavaScript 程式碼

js
const span = document.querySelector("span");
span.textContent = span.classList.contains("c")
  ? "The classList contains 'c'"
  : "The classList does not contain 'c'";

輸出如下所示

規範

規範
DOM
# ref-for-dom-domtokenlist-contains①

瀏覽器相容性