DOMTokenList: add() 方法

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

DOMTokenList 接口的 add() 方法将给定的 token 添加到列表中,忽略任何已经存在的 token。

语法

js
add(token1)
add(token1, token2)
add(token1, token2, /* …, */ tokenN)

参数

tokenN

一个代表要添加到 DOMTokenList 的 token(或 tokens)的字符串。

返回值

无。

异常

SyntaxError DOMException

如果其中一个参数为空字符串,则抛出此异常

InvalidCharacterError DOMException

如果 token 包含 ASCII 空白符,则抛出此异常

示例

在以下示例中,我们使用 Element.classList 检索设置在 <span> 元素上的类列表,该列表为一个 DOMTokenList。然后,我们将一个新 token 添加到列表中,并将该列表写入 <span>Node.textContent

首先,HTML 代码

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

现在是 JavaScript 代码

js
const span = document.querySelector("span");
const classes = span.classList;
classes.add("d");
span.textContent = classes;

输出如下所示

您也可以添加多个 token

js
span.classList.add("d", "e", "f");

规范

规范
DOM
# ref-for-dom-domtokenlist-add①

浏览器兼容性