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

DOMTokenList.toggle()

· 52CE 我爱测

DOMTokenList 接口的 **`toggle()`** 方法从列表中删除一个给定的标记并返回 `false`。如果标记不存在,则添加并且函数返回 `true`。

DOM

DOMTokenList 接口的 toggle() 方法从列表中删除一个给定的标记并返回 false。如果标记不存在,则添加并且函数返回 true。

语法

toggle(token);
toggle(token, force);

参数

  • token
    • : 一个字符串,表示你想要 toggle 的标记。
  • force
    • : 如果包含该值,设置后会将方法变成单向操作。如果设置为 false,仅会删除标记列表中匹配的给定标记,且不会再度添加。如果设置为 true,仅在标记列表中添加给定标记,且不会再度删除。

返回值

一个布尔值,true 或者 false,表示在调用 toggle 后,标记是否存在于列表中。

示例

在点击后 toggle class

以下示例我们使用 Element.classList 检索 span 元素的 class 集合列表(其返回值为 DOMTokenList)。然后我们替换集合中的一个标记,并将集合写入 <span> 的 Node.textContent

这是 HTML:

<span class="a b">classList is 'a b'</span>

现在是 JavaScript:

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

span.addEventListener("click", () => {
  const result = classes.toggle("c");

  if (result) {
    span.textContent = `'c' added; classList is now "${classes}".`;
  } else {
    span.textContent = `'c' removed; classList is now "${classes}".`;
  }
});

输出如下所示,并且每次点击文本时都会发生变化:

在点击后 toggle class

设置 force 参数

第二个参数可以用于决定是否包含 class 属性。这个例子仅在浏览器窗口宽度超过 1000 像素时才会包含‘c’属性。

span.classList.toggle("c", window.innerWidth > 1000);

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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