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①

浏览器兼容性