DOMTokenList：add() 方法

add() 方法是 DOMTokenList 接口的方法，它将给定的标记添加到列表中，省略任何已经存在的标记。

语法

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

参数

tokenN

表示要添加到 DOMTokenList 的标记（或标记）的字符串。

返回值

无。

异常

SyntaxError DOMException

如果其中一个参数是空字符串，则抛出。

InvalidCharacterError DOMException

如果标记包含 ASCII 空白符，则抛出。

示例

在以下示例中，我们使用 Element.classList 获取在 <span> 元素上设置的类列表作为 DOMTokenList。然后，我们向列表中添加一个新标记，并将列表写入 <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;

输出如下所示

您也可以添加多个标记

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

规范

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。