大网数据广告活动
Web 标准与前端开发

DOMTokenList:add() 方法

· 52CE 我爱测

DOMTokenList 接口的 **`add()`** 方法用于将指定的标记添加到列表中,已存在的标记会被自动忽略。

DOM

DOMTokenList 接口的 add() 方法用于将指定的标记添加到列表中,已存在的标记会被自动忽略。

语法

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

参数

  • tokenN
    • : 表示要添加到 DOMTokenList 中的一个或多个标记的字符串。

返回值

无。

异常

  • SyntaxError DOMException
    • : 当任意参数为空字符串时抛出。
  • InvalidCharacterError DOMException
    • : 当标记中包含 ASCII 空白字符时抛出。

示例

在以下示例中,我们使用 Element.classList 获取设置在 span 元素上的类列表(即一个 DOMTokenList)。随后,我们向该列表中添加一个新的标记,并将更新后的列表写入 <span> 元素的 Node.textContent 中。

首先是 HTML:

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

接着是 JavaScript:

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

输出结果如下所示:

示例

你也可以一次性添加多个标记:

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

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。